共用方式為


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 函式即可取得其維度。

文字對齊旗標會決定 TextOutExtTextOut 函式如何對齊文字字串,與提供給 TextOutExtTextOut 的字串參照點有關。

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

  • TA_LEFT、TA_RIGHT和TA_CENTER
  • TA_BOTTOM、TA_TOP和TA_BASELINE
  • TA_NOUPDATECP和TA_UPDATECP
如果目前的字型具有垂直預設基底線,則相關的旗標如下列清單所示。
  • TA_LEFT、TA_RIGHT和VTA_BASELINE
  • TA_BOTTOM、TA_TOP和VTA_CENTER
  • TA_NOUPDATECP和TA_UPDATECP

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

  1. 將位 OR 運算子套用至 旗標及其相關旗標。
  2. 將位 AND 運算子套用至結果和傳回值。
  3. 測試此結果和旗標是否相等。

範例

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

規格需求

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

另請參閱

ExtTextOut

字型和文字函式

字型和文字概觀

GetTextExtentPoint32

SetTextAlign

TextOut