计算机函数,功能为该函数将一个字符串写到指定的位置,并按制表位位置
数组里的值展开
制表符。正文以当前选择的字体、背景色和字体写入。
函数原型
;LONG TabbedTextOut(HDC hdc, int X, int Y, LPCTSTR lpString, int nCount, int nTabPositions, LPINT lpn TabStopPositions, int nTabOrigin);
参数
hDC:设备环境句柄。
X:字符串开始点的X坐标(按逻辑单位)。
Y:字符串开始点的Y坐标(按逻辑单位)。
nTabPosition:指定制表位位置
数组里的值的个数。
lpnTabStopPositions:指向数组的
指针,该数组含有制表位位置(按逻辑单位)。制表位必须按升序保存,最小的X值必须是
数组的第一项。
Windows 95:一个
制表位可被指定为负值,这会使在制表位上正文右对齐,而不是左对齐。
nTabOrigin:指定制表符展开的开始位置的X坐标(按逻辑单位)。
返回值:如果
函数调用成功,返回值是字符串的尺寸(按逻辑单位)。高位字表示高度,低位字表示宽度;如果
函数调用失败,返回值是0。
Windows NT:若想获得更多
错误信息,请调用GetLast
Error函数。
备注:如果nTabPositions值为0,且lpnTabStopPositions值为NULL则
制表符将会按平均字符宽度的8位来扩展。
如果nTabPositions值为1,则制表位按在lpnTabStopPositions中的第一个值指定的距离来分隔。
如果lpnTabStopPositions
数组包含一个以上的话,则制表位被设为数组里的每一个值,共为lpnTabStopPositions个。
NtabOrigin参数允许一个应用程序为一行多次调用TabbedTextOut。如果应用程序多次调用TabbedTextOut,nTabOrigin每次都设置相同的值,则此函数在相对于nTabOrigin指定的位置处展开所有的
制表符。
缺省地,TabbedTextOut不会使用和改变当前位置,当一个应用程序需要在调用TabbedTextOut时改变当前位置,可以通过设置wFlags为TA_UPDATECP,调用SetTextAlign来实现。当该标志被设置时,系统会在随后调用TabbedTextOut时忽略参数X和Y的值,而使用当前位置。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:不支持;头文件:wingdi.h;库文件:gdi32.lib;Unicode:在Windows NT环境下实现为Unicode和ANSI两种版本。