GetTextCharacterExtra function (wingdi.h)

Article
02/22/2024

The GetTextCharacterExtra function retrieves the current intercharacter spacing for the specified device context.

Syntax

int GetTextCharacterExtra(
  [in] HDC hdc
);

Parameters

[in] hdc

Handle to the device context.

Return value

If the function succeeds, the return value is the current intercharacter spacing, in logical coordinates.

If the function fails, the return value is 0x8000000.

Remarks

The intercharacter spacing defines the extra space, in logical units along the base line, that the TextOut or ExtTextOut functions add to each character as a line is written. The spacing is used to expand lines of text.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	wingdi.h (include Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll