setTextAlign 函数 (wingdi.h)

SetTextAlign 函数为指定的设备上下文设置文本对齐标志。

语法

UINT SetTextAlign(
  [in] HDC  hdc,
  [in] UINT align
);

[in] hdc

设备上下文的句柄。

[in] align

使用以下列表中值的掩码的文本对齐方式。只能从影响水平和垂直对齐的标志中选择一个标志。此外，只能选择更改当前位置的两个标志中的一个。

值	含义
TA_BASELINE	参考点将位于文本的基行上。
TA_BOTTOM	参考点将位于边框的下边缘。
TA_TOP	参考点将位于边框的上边缘。
TA_CENTER	参考点将与边框中心水平对齐。
TA_LEFT	参考点将位于边框的左边缘。
TA_RIGHT	参考点将位于边框的右边缘。
TA_NOUPDATECP	每次文本输出调用后，当前位置不会更新。引用点将传递给文本输出函数。
TA_RTLREADING	Windows 中东语言版本：文本按从右到左的阅读顺序排列，而不是默认的从左到右的顺序。仅当在设备上下文中选择的字体是希伯来语或阿拉伯语时，这才适用。
TA_UPDATECP	每次文本输出调用后，当前位置都会更新。当前位置用作参考点。

如果当前字体具有垂直默认基线（与汉字一样），则必须使用以下值，而不是TA_BASELINE和TA_CENTER。

值	含义
VTA_BASELINE	参考点将位于文本的基行上。
VTA_CENTER	参考点将与边框的中心垂直对齐。

默认值为 TA_LEFT、TA_TOP 和 TA_NOUPDATECP。

如果函数成功，则返回值为以前的文本对齐设置。

如果函数失败，则返回值GDI_ERROR。

TextOut 和 ExtTextOut 函数使用文本对齐标志在显示器或其他设备上放置文本字符串。标志指定引用点与绑定文本的矩形之间的关系。引用点是当前位置或传递给文本输出函数的点。

绑定文本的矩形由文本字符串中的字符单元格构成。

获取左对齐文本的最佳方式是使用任一


SetTextAlign (hdc, GetTextAlign(hdc) & (~TA_CENTER))

或


SetTextAlign (hdc,TA_LEFT | <other flags>)

还可以将 SetTextAlign (hdc TA_LEFT) 用于此目的，但这会丢失任何垂直或从右到左的设置。

注意使用 ScriptStringOut 时，不应将 SetTextAlign 与 TA_UPDATECP 一起使用，因为所选文本未正确呈现。如果必须使用此标志，可以根据需要取消设置并重置它以避免此问题。

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


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