函式功能
該 函式獲得指定的 設備環境下的 文字對齊方式的設定。函式原型
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。