GetTextAlign

函式功能

該函式獲得指定的設備環境下的文字對齊方式的設定。

函式原型：UINT GetTextAlign(HDC hdc)；

參數：

hdc：設備環境句柄。

返回值：如果函式調用成功，返回值是文字對齊標誌的狀態。要了解返回值的更多信息，參見備註。返回值是下列值的組合：

TA_BASELINE：基準點在正文的基線上。TA_BOTTOM：基準點在限定矩形的下邊界上。

TA_TOP：基準點在限定矩形的上邊界上。TA_CENTER：基準點與限定矩形的中心水平對齊。

TA_LEFT：基準點在限定矩形的左邊界上。TA_RIGHT：基準點在限定矩形的右邊界上。

TA_RTLREADING：對於中東Windows版，正文從右到左的閱讀順序排列，與預設的從左到右正好相反。

只有當被選擇的字型是Hebrew或Arabic時，此值才有用。

TA_NOUPDATECP：每次輸出調用後當前狀態不改變。TA_UPDATECP：每次輸出調用後當前狀態改變。

若當前字型有一條預設的垂直基線（如Kanji），下列值用於取代TA_BASELINE和TA_CENTER，各值含義為：

VTA_BASELINE：基準點在正文的基線上。VTA_CENTER：基準點與限定矩形的中心垂直對齊。

如果函式調用失敗，返回值是GDI-ERROR。

Windows：若想獲得更多的錯誤信息，請調用GetLastError函式。

備註：限定矩形是指能將正文字元串的所有字元單元限定於其中的矩形。其尺寸可調用GetTextextentPoint32來獲得。

文字對齊標誌決定TextOut和ExtTextOut如何將正文字元串與基準點對齊。

文字對齊標誌不必是單個的標誌位，可以等於0。標誌必須按相關的組來檢查，如下所示：

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 NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；頭檔案：wingdi.h；庫檔案：gdi32.lib。