### 函数功能

该函数为指定设备环境设置文字对齐标志。

### 函数原型

UINT SetTextAlign(HDC hdc, UINT fMode)；

### 参数

hdc：设备环境句柄。
fMode：使用下列值的掩码指定文件对齐方式。从水平和垂直对齐标志里只能选择一个。另外，对改变前状态的两个标志只能选择一个。各值含义参见GetTextAlign。缺省值是TA_LEFT, TA_TOP和TA_NOUPDATECP。

### 返回值

如果函数调用成功，返回值是文字对齐方式的前一个设置；如果函数调用失败，返回值是GDI_ERROR。
Windows NT：若想获得更多错误信息，请调用GetLastError函数。
备注：TextOut和ExtTextOut用文字对齐标志来将一个正文字符串在显示时定位或定位于其他设备。该示志指定基准点与限定正文的矩形的位置关系，基准点可以是当前位置，也可是传给正文输出函数的一个点。限定正文的矩形是正文字符串里的字符单元形成的。

### 速查

Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：wingdi.h；库文件：gdi32.lib。