描述
GetTextAlign函数检索指定设备上下文的文本对齐设置。
C++ 语法
UINT GetTextAlign( __in HDC hdc ); |
PowerBASIC 语法
FUNCTION GetTextAlign ( _ BYVAL hdc AS DWORD _ ) AS DWORD |
参数
hdc
[in]处理设备上下文。
返回值
如果函数成功，返回值就是文本对齐标志的状态。有关返回值的更多信息，请参阅备注部分。返回值是以下值的组合。
值 |
含义 |
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
验证在该函数的返回值中设置了特定的标志:
| 1. | 将按位OR运算符应用到标志及其相关标志。 |
| 2. | 对结果和返回值应用按位AND运算符。 |
| 3. | 测试这个结果和标志的相等性。 |
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）