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

另请参阅

DrawText

字体和文本函数

字体和文本概述

GetTextCharacterExtra

TextOut