GetTextAlign

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。

相關詞條

相關搜尋

熱門詞條

聯絡我們