GetTextExtentPoint

GetTextExtentExPoint該函式取得一個指定字元串里的字元數,該字元串將符合一個指定的空間,並且將其中每一個字元的範圍放入一個數組。

函式部份

函式功能:該函式取得一個指定字元串里的字元數,該字元串將符合一個指定的空間,並且將其中每一個字元的範圍放入一個數組。(一個正文的範圍是指空間開始處到一個字元的間距)。此函式對自動換行的計算非常有用。
函式原型: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兩種版本。

相關詞條

相關搜尋

熱門詞條

聯絡我們