TabbedTextOut

計算機函式，功能為該函式將一個字元串寫到指定的位置，並按定位點位置數組里的值展開制表符。正文以當前選擇的字型、背景色和字型寫入。

基本介紹

• 中文名：TabbedTextOut
• 屬性：函式
• 原型：LONG TabbedTextOut
• 所屬：計算機函式

函式原型

；LONG TabbedTextOut(HDC hdc, int X, int Y, LPCTSTR lpString, int nCount, int nTabPositions, LPINT lpn TabStopPositions, int nTabOrigin)；

參數

hDC：設備環境句柄。

X：字元串開始點的X坐標（按邏輯單位）。

Y：字元串開始點的Y坐標（按邏輯單位）。

lpString：指向將被繪製的字元串的指針，此字元串不必以\0結束，因為nCount指定的字元串的長度。

nCount：指定字元串里的字元數。

nTabPosition：指定製表位位置數組里的值的個數。

lpnTabStopPositions：指向數組的指針，該數組含有定位點位置（按邏輯單位）。定位點必須按升序保存，最小的X值必須是數組的第一項。

Windows 95：一個定位點可被指定為負值，這會使在定位點上正文右對齊，而不是左對齊。

nTabOrigin：指定製表符展開的開始位置的X坐標（按邏輯單位）。

返回值：如果函式調用成功，返回值是字元串的尺寸（按邏輯單位）。高位字表示高度，低位字表示寬度；如果函式調用失敗，返回值是0。

Windows NT：若想獲得更多錯誤信息，請調用GetLastError函式。

備註：如果nTabPositions值為0，且lpnTabStopPositions值為NULL則制表符將會按平均字元寬度的8位來擴展。

如果nTabPositions值為1，則定位點按在lpnTabStopPositions中的第一個值指定的距離來分隔。

如果lpnTabStopPositions數組包含一個以上的話，則定位點被設為數組裡的每一個值，共為lpnTabStopPositions個。

NtabOrigin參數允許一個應用程式為一行多次調用TabbedTextOut。如果應用程式多次調用TabbedTextOut，nTabOrigin每次都設定相同的值，則此函式在相對於nTabOrigin指定的位置處展開所有的制表符。

預設地，TabbedTextOut不會使用和改變當前位置，當一個應用程式需要在調用TabbedTextOut時改變當前位置，可以通過設定wFlags為TA_UPDATECP，調用SetTextAlign來實現。當該標誌被設定時，系統會在隨後調用TabbedTextOut時忽略參數X和Y的值，而使用當前位置。

速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；頭檔案：wingdi.h；庫檔案：gdi32.lib；Unicode：在Windows NT環境下實現為Unicode和ANSI兩種版本。