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 的字符串引用点对齐文本字符串。

文本对齐标志不一定是单位标志，可能等于零。必须在相关标志组中检查标志，如以下列表所示。

如果当前字体具有垂直默认底线，则相关标志如以下列表所示。

验证是否在此函数的返回值中设置了特定标志：

有关示例，请参阅设置文本对齐方式。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll