勇芳软件工作室.汉化:  Fonts and Text > Fonts and Text Functions >

SetTextCharacterExtra

Previous pageReturn to chapter overviewNext page

描述

 

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)