GetTextAlign函数检索指定设备上下文的文本对齐设置。
UINT GetTextAlign(
HDC 【HDC】 | //设备上下文的句柄 |
); |
参数
【HDC】
标识设备上下文。
返回值
如果函数成功,返回值就是文本对齐标志的状态。
如果函数失败,返回值为GDI_ERROR.要获取扩展错误信息,请调用GetLastError.
有关状态返回值的列表,请参阅备注部分。返回值是以下值中的一个或多个的组合:
值 | 含义 |
TA_BASELINE | 参考点在文本的基线上。 |
TA_BOTTOM | 参考点位于边界矩形的下边缘。 |
TA_TOP | 参考点位于边界矩形的顶边。 |
TA_CENTER | 参考点与边界矩形的中心水平对齐。 |
TA_LEFT | 参考点位于边界矩形的左边缘。 |
TA_RIGHT | 参考点位于边界矩形的右边缘。 |
TA_RTLREADING | 仅Windows 95:文本从右到左阅读顺序布局,而不是默认的从左到右的顺序。这仅适用于在设备上下文中选择的字体为希伯来语或阿拉伯语。 |
TA_NOUPDATECP | 每次文本输出调用后,当前位置都不会被更新。 |
TA_UPDATECP | 每个文本输出调用后,当前位置都会被更新。 |
当当前字体具有垂直默认基线(与汉字一样)时,将使用以下值代替TA_BASELINE和TA_CENTER:
值 | 含义 |
VTA_BASELINE | 参考点在文本的基线上。 |
VTA_CENTER | 参考点与边界矩形的中心垂直对齐。 |
备注
边界矩形是一个限定文本字符串中所有字符单元格的矩形。其尺寸可以通过调用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运算符应用到标志及其相关标志。
2.将按位AND运算符应用于结果和返回值。
3.测试这个结果和国旗的平等。
也可以看看