函数功能:该函数取得一个指定字符串里的字符数,该字符串将符合一个指定的空间,并且将其中每一个字符的范围放入一个数组。(一个正文的范围是指空间开始处到一个字符的间距)。此函数对自动换行的计算非常有用。
1 |
BOOL GetTextExtentPoint(HDC hdc, LPCTSTR lpszStr, int cchString, int nMaxExten, LPINT lpnFit, LPINT alpDx, LPSIZE lpSize); |
参数:
hdc:设备环境句柄。
lpszStr:指向以 (Null)结束的字符串的指针,函数取得该字符中的范围。
cchString:指定由lpszStr指向的字符串的字节数。
nMaxExtent:为格式经的字符串指定最大可允许的逻辑单位宽度。
lpnFit:指向整数的指针,该整数用于接收符合指定范围的字符的最大个数,该范围由nMaxExtent指定。如果lpnFit为NULL,则nMaxExtent无效。
alpDx:指向整数数组的指针,该数组用于接收部分字符串范围。此数组的每一个元素给出一个间隔值,(按逻辑单位),表示字符串的开始处和在由nMaxExtent指定的空间里的一个字符之间的距离。尽管此数组应当至少有cchString指定那么多个元素,但函数向数组中填入其范围的字符数却由lpnFit确定。如果alpDx为NULL,则函数不计算局部字符串宽度。
lpSize:指向结构SIZE的指针,该结构在函数返回时含有字符串的尺寸(按逻辑单位)。
返回值:如果函数调用成功,返回值非零,如果函数调用失败,返回值是0。
Windows NT:若想获得更多错误信息,请调用GetLastError函数。
备注:如果lpnFit和alpDx的值均为NULL,则调用GetTextExtentPoint等同于调用GetTextExtentExPoint。
Windows CE:cchString指定由lpszStr指向的字符串的字符个数而不是字节数。在Windows桌面平台下也是如此。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:1.0及以上版本;头文件:wingdi.h;库文件:gdi32.lib;Unicode:在Windows NT环境下实现为Unicode和ANSI两种版本。