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 函数来获取其维度。

文本对齐标志确定 TextOutExtTextOut 函数如何相对于提供给 TextOutExtTextOut 的字符串引用点对齐文本字符串。

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

  • 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

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

  1. 将按位 OR 运算符应用于标志及其相关标志。
  2. 将按位 AND 运算符应用于结果和返回值。
  3. 测试此结果和标志的相等性。

示例

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

要求

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

另请参阅

ExtTextOut

字体和文本函数

字体和文本概述

GetTextExtentPoint32

SetTextAlign

TextOut