SetTextCharacterExtra 函数 (wingdi.h)

SetTextCharacterExtra 函数设置字符间间距。当系统写入文本行时，会将字符间间距添加到每个字符（包括分隔符）。

语法

int SetTextCharacterExtra(
  [in] HDC hdc,
  [in] int extra
);

[in] hdc

设备上下文的句柄。

[in] extra

要添加到每个字符的额外空间量（以逻辑单元为单位）。如果当前映射模式未MM_TEXT，则 nCharExtra 参数将转换并舍入到最接近的像素。

如果函数成功，则返回值为前面的字符间间距。

如果函数失败，则返回值0x80000000。

此函数主要是为了与现有应用程序兼容而受支持。新应用程序通常应避免调用此函数，因为它与需要文本整形的复杂脚本 (脚本不兼容;阿拉伯文脚本就是此) 的一个示例。

建议的方法是，应用程序应调用 ExtTextOut 并使用其 lpDx 参数提供宽度，而不是调用此函数，然后调用 TextOut。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll