GetTextExtentPoint

GetTextExtentExPoint該函式取得一個指定字元串里的字元數，該字元串將符合一個指定的空間，並且將其中每一個字元的範圍放入一個數組。（一個正文的範圍是指空間開始處到一個字元的間距）。此函式對自動換行的計算非常有用。

基本介紹

  • 中文名：GetTextExtentExPoint
  • 函式原型：BOOL GetTextExtentExPoint
  • hdc：設備環境句柄
  • 頭檔案：wingdi.h
  • 庫檔案：gdi32.lib
簡介
函式原型：BOOL GetTextExtentExPoint(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，則調用GetTextExtentExPoint等同於調用GetTextExtentPoint。
Windows CE：cchString指定由lpszStr指向的字元串的字元個數而不是位元組數。在Windows桌面平台下也是如此。
速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；頭檔案：wingdi.h；庫檔案：gdi32.lib；Unicode：在Windows NT環境下實現為Unicode和ANSI兩種版本。

相關詞條

熱門詞條

聯絡我們