set_text_character_extra


int set_text_character_extra(handle device,
                             int extra)

This function sets the extra character spacing for text.

Parameters

handle device

The handle of the device context.

int extra

The extra spacing for characters (in logical units).

Return

int

The previous extra character spacing or -1 if an error occurred.

Notes

The intercharacter spacing (character extra value) is added to all characters - including break characters.

If the unit mode is not unit::pixel, the character extra value is transformed then rounded to the nearest pixel.