函数功能:该函数获得指定的设备环境下的文字对齐方式的设置。

    函数原型: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。