词条 | GetTextExtentPoint |
释义 | 函数功能:该函数取得一个指定字符串里的字符数,该字符串将符合一个指定的空间,并且将其中每一个字符的范围放入一个数组。(一个正文的范围是指空间开始处到一个字符的间距)。此函数对自动换行的计算非常有用。 函数原型:BOOL GetTextExtentPoint(HDC hdc, LPCTSTR lpszStr, int cchString, int nMaxExten, LPINT lpnFit, LPINT alpDx, LPSIZE lpSize); 参数: hdc:设备环境句柄。 lpszStr:指向以\\0(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两种版本。 |
随便看 |
百科全书收录4421916条中文百科知识,基本涵盖了大多数领域的百科知识,是一部内容开放、自由的电子版百科全书。