描述
TabbedTextOut函数在指定位置写入一个字符串，将制表符扩展为一个tab-stop位置数组中指定的值。文本以当前选定的字体，背景颜色和文字颜色编写。
C++ 语法
LONG TabbedTextOut( __in HDC hDC, __in int X, __in int Y, __in LPCTSTR lpString, __in int nCount, __in int nTabPositions, __in const LPINT lpnTabStopPositions, __in int nTabOrigin ); |
PowerBASIC 语法
FUNCTION TabbedTextOutA ( _ BYVAL hdc AS DWORD, _ BYVAL X AS LONG, _ BYVAL Y AS LONG, _ BYREF lpString AS ASCIIZ, _ BYVAL nCount AS LONG, _ BYVAL nTabPositions AS LONG, _ BYREF lpnTabStopPositions AS LONG, _ BYVAL nTabOrigin AS LONG _ ) AS LONG |
Unicode版本:
FUNCTION TabbedTextOutW ( _ BYVAL hdc AS DWORD, _ BYVAL X AS LONG, _ BYVAL Y AS LONG, _ BYREF lpString AS WSTRINGZ, _ BYVAL nCount AS LONG, _ BYVAL nTabPositions AS LONG, _ BYREF lpnTabStopPositions AS LONG, _ BYVAL nTabOrigin AS LONG _ ) AS LONG |
参数
hdc
[in]处理设备上下文。
X
[in]以逻辑单位指定字符串起始点的x坐标。
Y
[in]以逻辑单位指定字符串起始点的y坐标。
lpString
[in]指向要绘制的字符串的指针。该字符串不需要为零终止，因为NCOUNT指定字符串的长度。
nCount
[in]指定lpString指向的字符串的长度。
Windows 95/98 / Me：此值不得超过8192。
nTabPositions
[in]指定tab-stop位置数组中的值的数量。
lpnTabStopPositions
[in]指向包含制表位置位置的数组的指针，以逻辑单位。选项卡停止必须按增加的顺序排序;最小的x值应该是数组中的第一个项目。
Windows 95/98 / Me：可以将选项卡停止指定为负值，这会使文本在制表符停止而不是左对齐方向右对齐。
nTabOrigin
[in]以逻辑单位指定展开标签的起始位置的x坐标。
返回值
如果函数成功，则返回值是字符串的逻辑单位的维度。高度在高位字中，宽度在低位字中。
如果函数失败，返回值为零。
备注
如果nTabPositions参数为零并且lpnTabStopPositions参数为NULL，则选项卡将展开为平均字符宽度的八倍。
如果nTabPositions为1，则制表符停止以lpnTabStopPositions数组中第一个值指定的距离分隔。
如果lpnTabStopPositions数组包含多个值，则会为数组中的每个值设置一个制表符停止，最多为nTabPositions指定的数字。
nTabOrigin参数允许应用程序为单行调用TabbedTextOut函数多次。如果应用程序多次调用TabbedTextOut，每次都将nTabOrigin设置为相同的值，该函数将相对于nTabOrigin指定的位置扩展所有选项卡。
默认情况下，当前位置不被TabbedTextOut功能使用或更新。如果应用程序在调用TabbedTextOut时需要更新当前位置，则应用程序可以将wFlags参数设置为TA_UPDATECP来调用SetTextAlign函数。当设置此标志时，系统会忽略后续调用TabbedTextOut函数的X和Y参数，而不是使用当前位置。
Windows 95/98 / Me：Microsoft Layer for Unicode支持TabbedTextOutW.
引用文件 #INCLUDE Once
Winuser.inc（包括Windows.inc）