GetTextExtentExPoint

【勇芳软件工作室】汉化HomePreviousNext

GetTextExtentExPoint函数检索指定字符串中适合指定空间的字符数,并使用每个字符的文本扩展名填充数组。(文本范围是空格开头和适合空格的字符之间的距离。)此信息对于文字包装计算非常有用。

BOOL GetTextExtentExPoint(

HDC 【HDC】,//设备上下文的句柄
LPCTSTR 【lpszStr】,//字符串的地址
INT 【cchString】,//字符串中的字符数
INT 【nMaxExtent】,//格式化字符串的最大宽度
LPINT 【lpnFit】,//指定最大值的地址字符数量
LPINT 【alpDx】,//部分字符串宽度的数组地址
LPSIZE 【lpsiz到】//具有字符串尺寸的结构的地址
); 

参数

【HDC】

标识设备上下文。

【lpszStr】

指向要检索的区域的以null结尾的字符串。

【cchString】

指定【lpszStr】参数指向的字符串中的字节数。

【nMaxExtent】

指定格式化字符串的最大容许宽度(以逻辑为单位)。

【lpnFit】

指向一个整数,以接收适合【nMaxExtent】参数指定空间的最大字符数的计数。当【lpnFit】参数为NULL时,【nMaxExtent】参数将被忽略。

【alpDx】

指向一个整数数组,以接收部分字符串扩展。数组中的每个元素都以逻辑单位给出符合【nMaxExtent】参数指定空间的字符串之间的距离。尽管此数组应至少与【cchString】参数指定的字符数一样多,但该函数仅使用由【lpnFit】参数给出的字符填充扩展数组。如果【alpDx】为NULL,则该函数不计算部分字符串宽度。

【lpsiz到】

指向包含字符串维度的SIZE结构,以函数返回的逻辑单位。此值不能为NULL。

返回值

如果函数成功,返回值不为零。

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

如果【lpnFit】【alpDx】参数都为NULL,则调用GetTextExtentExPoint函数等效于调用GetTextExtentPoint函数。

也可以看看

GetTextExtentPoint, SIZE