SetTextAlign函数设置指定设备上下文的文本对齐标志。
UINT SetTextAlign(
HDC 【HDC】, | //设备上下文的句柄 |
UINT 【FMODE】 | //文本对齐标志 |
); |
参数
【HDC】
标识设备上下文。
【FMODE】
通过使用以下列表中的值的掩码来指定文本对齐。只有一个标志可以从影响水平和垂直对齐的那些标志中选出。另外,只能改变当前位置的两个标志之一。
值 | 含义 |
TA_BASELINE | 参考点将在文本的基线上。 |
TA_BOTTOM | 参考点将在边界矩形的下边缘。 |
TA_TOP | 参考点将位于边界矩形的顶边。 |
TA_CENTER | 参考点将与边界矩形的中心水平对齐。 |
TA_LEFT | 参考点将在边界矩形的左边缘。 |
TA_RIGHT | 参考点将在边界矩形的右边缘。 |
TA_NOUPDATECP | 每次文本输出调用后,当前位置都不会被更新。参考点被传递给文本输出功能。 |
TA_RTLREADING | 仅Windows 95:文本从右到左阅读顺序布局,而不是默认的从左到右的顺序。这仅适用于在设备上下文中选择的字体为希伯来语或阿拉伯语。 |
TA_UPDATECP | 每个文本输出调用后,当前位置都会被更新。当前位置用作参考点。 |
当当前字体具有垂直默认基线时,与汉字一样,必须使用以下值而不是TA_BASELINE和TA_CENTER:
值 | 含义 |
VTA_BASELINE | 参考点将在文本的基线上。 |
VTA_CENTER | 参考点将与边界矩形的中心垂直对齐。 |
默认值为TA_LEFT,TA_TOP和TA_NOUPDATECP。
返回值
如果函数成功,返回值就是以前的文本对齐设置。
如果函数失败,返回值为GDI_ERROR。要获取扩展错误信息,请调用GetLastError.
备注
TextOut和ExtTextOut功能使用文本对齐标志将文本字符串放置在显示器或其他设备上。标志指定参考点和界定文本的矩形之间的关系。参考点是当前位置或传递给文本输出功能的点。
界定文本的矩形由文本字符串中的字符单元形成。
也可以看看