SetTextAlign 函式 (wingdi.h)

SetTextAlign函式會設定指定裝置內容的文字對齊旗標。

語法

UINT SetTextAlign(
  [in] HDC  hdc,
  [in] UINT align
);

[in] hdc

裝置內容的控制碼。

[in] align

使用下列清單中的值遮罩來對齊文字。只有一個旗標可以從影響水準和垂直對齊的旗標中選擇。此外，只能選擇改變目前位置的兩個旗標之一。

值	意義
TA_BASELINE	參考點會位於文字的基底行上。
TA_BOTTOM	參考點會位於周框的下邊緣。
TA_TOP	參考點會位於周框的上邊緣。
TA_CENTER	參考點會水準對齊周框的中心。
TA_LEFT	參考點會位於周框的左邊緣。
TA_RIGHT	參考點會位於周框的右邊緣。
TA_NOUPDATECP	在每個文字輸出呼叫之後，目前的位置不會更新。參考點會傳遞至文字輸出函式。
TA_RTLREADING	Windows 的中東語言版本：文字會以從右至左讀取順序配置，而不是預設的由左至右順序。只有在選取到裝置內容的字型為希伯來文或阿拉伯文時，才適用。
TA_UPDATECP	每個文字輸出呼叫之後，都會更新目前的位置。目前的位置會當做參考點使用。

當目前的字型具有垂直預設基底線，如同漢字一樣，必須使用下列值，而不是TA_BASELINE和TA_CENTER。

值	意義
VTA_BASELINE	參考點會位於文字的基底行上。
VTA_CENTER	參考點會垂直對齊周框的中心。

預設值為 TA_LEFT、TA_TOP 和 TA_NOUPDATECP。

如果函式成功，則傳回值是先前的文字對齊設定。

如果函式失敗，傳回值會GDI_ERROR。

TextOut和ExtTextOut函式會使用文字對齊旗標，在顯示或其他裝置上放置文字字串。旗標會指定參考點與系結文字的矩形之間的關聯性。參考點是目前的位置或傳遞至文字輸出函式的點。

系結文字的矩形是由文字字串中的字元儲存格所形成。

取得靠左對齊文字的最佳方式是使用任一個


SetTextAlign (hdc, GetTextAlign(hdc) & (~TA_CENTER))

或


SetTextAlign (hdc,TA_LEFT | <other flags>)

您也可以針對此目的使用 SetTextAlign (hdc TA_LEFT) ，但這會遺失任何垂直或由右至左的設定。

注意當您使用ScriptStringOut時，不應該搭配使用SetTextAlign與 TA_UPDATECP，因為選取的文字未正確轉譯。如果您必須使用這個旗標，您可以視需要取消設定並重設它，以避免發生問題。

如需範例，請參閱設定文字對齊。


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll