### 函数功能

该函数取得一个指定字符串里的字符数，该字符串将符合一个指定的空间，并且将其中每一个字符的范围放入一个数组。（一个正文的范围是指空间开始处到一个字符的间距）。此函数对自动换行的计算非常有用。

### 函数原型

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两种版本。