GetTabbedTextExtent

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

GetTabbedTextExtent函数计算字符串的宽度和高度。如果字符串包含一个或多个制表符,则字符串的宽度将基于指定的制表位。GetTabbedTextExtent功能使用当前选定的字体来计算字符串的尺寸。

DWORD GetTabbedTextExtent(

HDC 【hDC】,//设备上下文的句柄
LPCTSTR 【lpString】,//字符串的地址
INT 【NCOUNT】,//字符串中的字符数
INT 【nTabPositions】,//选项卡位置数
LPINT 【lpnTabStopPositions】//选项卡位置数组的地址
); 

参数

【hDC】

标识设备上下文。

【lpString】

指向一个字符串。

【NCOUNT】

指定文本字符串中的字符数。

【nTabPositions】

指定【lpnTabStopPositions】参数指向的数组中的制表位数。

【lpnTabStopPositions】

指向包含制表位置的数组,以设备为单位。选项卡停止必须按增加的顺序排序;最小的x值应该是数组中的第一个项目。

返回值

如果函数成功,返回值就是字符串的维数。高度在高位字中,宽度在低位字中。

如果函数失败,返回值为0。GetTabbedTextExtent将失败,如果【hDC】无效,如果【nTabPositions】小于0。

备注

当前剪辑区域不影响GetTabbedTextExtent函数返回的宽度和高度。

因为某些设备不会将字符放置在常规单元格阵列中(也就是说,它们是字符),字符串中字符的范围之和可能不等于字符串的范围。

如果【nTabPositions】参数为零并且【lpnTabStopPositions】参数为NULL,则选项卡将展开为平均字符宽度的八倍。

如果【nTabPositions】为1,则制表符停止将以由【lpnTabStopPositions】指向的数组中的第一个值指定的距离分隔。

也可以看看

GetTextExtentPoint32, HIWORD, LOWORD, TabbedTextOut