请输入您要查询的百科知识:

 

词条 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条中文百科知识,基本涵盖了大多数领域的百科知识,是一部内容开放、自由的电子版百科全书。

 

Copyright © 2004-2023 Cnenc.net All Rights Reserved
更新时间:2024/12/23 23:40:03