GetTabbedTextExtentA 函式 (winuser.h)
GetTabbedTextExtent 函式會計算字元字串的寬度和高度。 如果字串包含一或多個製表符,字串的寬度會以指定的製表位為基礎。 GetTabbedTextExtent 函式會使用目前選取的字型來計算字串的維度。
語法
DWORD GetTabbedTextExtentA(
[in] HDC hdc,
[in] LPCSTR lpString,
[in] int chCount,
[in] int nTabPositions,
[in] const INT *lpnTabStopPositions
);
參數
[in] hdc
裝置內容的句柄。
[in] lpString
字元字串的指標。
[in] chCount
文字字串的長度。 如果是 ANSI 函式,它是 BYTE 計數,而 Unicode 函式則是 WORD 計數。 請注意,針對 ANSI 函式,SBCS 代碼頁中的字元會各接受一個字節,而 DBCS 代碼頁中的大多數字元則採用兩個字節:針對 Unicode 函式,目前定義的 Unicode 字元(基本多語平面 (BMP) 中的字元是一個 WORD,而 Unicode 代理則是兩個 WORD。
[in] nTabPositions
lpnTabStopPositions 參數所指向之數位中的製表位位置數目。
[in] lpnTabStopPositions
數位的指標,其中包含裝置單位中的製錶位位置。 製表位必須依遞增順序排序;最小的 x 值應該是陣列中的第一個專案。
傳回值
如果函式成功,傳回值會是邏輯單元中字串的維度。 高度是高序字組,而寬度則為低序字組。
如果函式失敗,傳回值為 0。 如果 hDC 無效,且 nTabPositions 小於 0,則 getTabbedTextExtent 會失敗。
言論
目前的裁剪區域不會影響 getTabbedTextExtent 函式
由於某些裝置不會將字元放在一般單元格陣列中(也就是它們會縮小字元),字串中字元的範圍總和可能不等於字串串的範圍。
如果 nTabPositions 參數為零,且 lpnTabStopPositions 參數 NULL,索引卷標會展開為平均字元寬度的八倍。
如果 nTabPositions 為 1,製表位會以數位中第一個值所指定的距離分隔,lpnTabStopPositions 點。
注意
winuser.h 標頭會根據 UNICODE 預處理器常數的定義,將 GetTabbedTextExtent 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | winuser.h (包括 Windows.h) |
連結庫 | User32.lib |
DLL | User32.dll |