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 的字串參照點有關。
文字對齊旗標不一定是單一位旗標，而且可能等於零。 旗標必須在相關旗標群組中檢查，如下列清單所示。
- 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
若要確認此函式的傳回值中已設定特定旗標：
- 將位 OR 運算子套用至 旗標及其相關旗標。
- 將位 AND 運算子套用至結果和傳回值。
- 測試此結果和旗標是否相等。
範例
如需範例，請參閱 設定文字對齊。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | wingdi.h (包含 Windows.h) |
| 程式庫 | Gdi32.lib |
| Dll | Gdi32.dll |