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 的字符串引用点对齐文本字符串。
文本对齐标志不一定是单位标志,可能等于零。 必须在相关标志组中检查标志,如以下列表所示。
- 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 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | wingdi.h (包括 Windows.h) |
Library | Gdi32.lib |
DLL | Gdi32.dll |