描述
SetTextCharacterExtra函数设置字符间距。当系统写入一行文本时,将字符间距添加到每个字符,包括中断字符。
C++ 语法
int SetTextCharacterExtra( __in HDC hdc, __in int nCharExtra ); |
PowerBASIC 语法
FUNCTION SetTextCharacterExtra ( _ BYVAL hdc AS DWORD, _ BYVAL nCharExtra AS LONG _ ) AS LONG |
参数
hdc
[in]处理设备上下文。
nCharExtra
[in]指定要添加到每个字符的逻辑单位的额外空间量。如果当前映射模式不是MM_TEXT,则nCharExtra参数将被转换并舍入为最近的像素。
返回值
如果函数成功,则返回值是前一个字符间距。
如果函数失败,返回值为&H80000000。
备注
此函数主要用于与现有应用程序的兼容性。新应用程序通常应该避免调用此函数,因为它与复杂脚本(需要文本整形的脚本)不兼容;阿拉伯语脚本就是此示例。
推荐的方法是,应用程序应调用ExtTextOut并使用其lpDx参数来提供宽度,而不是调用此函数,然后调用此函数。
引用文件 #INCLUDE Once
WinGdi.inc(包括Windows.inc)