GetTextAlign 函式 (wingdi.h)

GetTextAlign 函式會擷取指定裝置內容的文字對齊設定。

語法

UINT GetTextAlign(
  [in] HDC hdc
);

[in] hdc

裝置內容的句柄。

如果函式成功，則傳回值會是文字對齊旗標的狀態。如需傳回值的詳細資訊，請參閱一節。傳回值是下列值的組合。

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

當目前的字型具有與漢字) 相同的垂直預設基底線 (時，會使用下列值，而不是TA_BASELINE和TA_CENTER。

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

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

周框是將文字字串中所有字元儲存格周框的矩形。呼叫 GetTextExtentPoint32 函式即可取得其維度。

文字對齊旗標會決定 TextOut 和 ExtTextOut 函式如何對齊文字字串，與提供給 TextOut 或 ExtTextOut 的字串參照點有關。

文字對齊旗標不一定是單一位旗標，而且可能等於零。旗標必須在相關旗標群組中檢查，如下列清單所示。

如果目前的字型具有垂直預設基底線，則相關的旗標如下列清單所示。

若要確認此函式的傳回值中已設定特定旗標：

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

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