TabbedTextOutA 函式（winuser.h）

發行項
11/20/2024

TabbedTextOut 函式會在指定的位置寫入字元字串，將索引標籤展開至定位點位置陣列中指定的值。文字會以目前選取的字型、背景色彩和文字色彩撰寫。

語法

LONG TabbedTextOutA(
  [in] HDC       hdc,
  [in] int       x,
  [in] int       y,
  [in] LPCSTR    lpString,
  [in] int       chCount,
  [in] int       nTabPositions,
  [in] const INT *lpnTabStopPositions,
  [in] int       nTabOrigin
);

參數

[in] hdc

裝置內容的句柄。

[in] x

字串起點的 X 座標，以邏輯單位表示。

[in] y

字串起點的 Y 座標，以邏輯單位表示。

[in] lpString

要繪製之字元字串的指標。字串不需要以零結束，因為 nCount 會指定字串的長度。

[in] chCount

lpString所指向之字串的長度。

[in] nTabPositions

定位點位置陣列中的值數目。

[in] lpnTabStopPositions

陣列的指標，其中包含邏輯單元中的製表位位置。製表位必須依遞增順序排序;最小的 x 值應該是陣列中的第一個專案。

[in] nTabOrigin

索引標籤展開之起始位置的 X 座標，以邏輯單位表示。

傳回值

如果函式成功，傳回值會是字串的邏輯單位維度。高度是高序字組，而寬度則為低序字組。

如果函式失敗，傳回值為零。

言論

如果 nTabPositions 參數為零，且 lpnTabStopPositions 參數 NULL，索引卷標會展開為平均字元寬度的八倍。

如果 nTabPositions 為 1，製表位會以 lpnTabStopPosition s 陣列中第一個值所指定的距離分隔。

如果 lpnTabStopPositions 陣列包含一個以上的值，則會針對數位中的每個值設定製表位，最多 nTabPositions所指定的數位。

nTabOrigin 參數可讓應用程式針對單行呼叫 TabbedTextOut 函式數次。如果應用程式每次呼叫 TabbedTextOut 多次，且 nTabOrigin 設定為相同的值，則函式會展開與 nTabOrigin 所指定位置相對的所有索引卷標。

根據預設，TabbedTextOut 函式不會使用或更新目前的位置。如果應用程式在呼叫 TabbedTextOut 時需要更新目前的位置，應用程式可以使用設定為 TA_UPDATECP 的 wFlags 參數呼叫 SetTextAlign 函式。設定此旗標時，系統會在後續 呼叫 tabbedTextOut 函式時忽略 X 和 Y 參數。

Note For Windows Vista 和更新版本，TabbedTextOut 在繪製文字時忽略文字對齊方式。

注意

winuser.h 標頭會將 TabbedTextOut 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winuser.h （包括 Windows.h）
連結庫	User32.lib
DLL	User32.dll
API 集	ext-ms-win-ntuser-misc-l1-5-1 （在 Windows 10 版本 10.0.14393 中引進）