SetTextCharacterExtra

2.x

  int SetTextCharacterExtra(hdc, nExtraSpace)    
  HDC hdc; /* handle of device context */
  int nExtraSpace; /* extra character spacing */

The SetTextCharacterExtra function sets the amount of intercharacter spacing. The graphics device interface (GDI) adds this spacing to each character, including break characters, when it writes a line of text to the device context.

Parameters

hdc

Identifies the device context.

nExtraSpace

Specifies the amount of extra space, in logical units, to be added to each character. If the current mapping mode is not MM_TEXT, this parameter is transformed and rounded to the nearest pixel.

Return Value

The return value is the previous intercharacter spacing, if the function is successful.

Comments

The default value for the amount of intercharacter spacing is zero.

See Also

GetTextCharacterExtra