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函数。
也可以看看