CDC::TabbedTextOut
virtual CSize TabbedTextOut(
int x,
int y,
LPCTSTR lpszString,
int nCount,
int nTabPosition,
LPINT lpnTabStopPosition,
int nTabOrigin
);
CSize TabbedTextOut(
int x,
int y,
const CString& str,
int nTabPosition,
LPINT lpnTabStopPositions,
int nTabOrigin
);
返回值:返回CSize对象,是用逻辑单位表示的字符串尺寸。
参数:
x
指定字符串起点的X逻辑坐标。
y
指定字符串起点的Y逻辑坐标。
lpszString
要绘制的字符串的指针。可以为该参数传递CString对象数组的指针。
nCount
指定字符串中的字符数。如果nCount为-1,其长度则可计算。
nTabPositions
制表键停顿位数组中的个数。
lpnTabStopPosition
包含制表键停顿位(逻辑单位)的数组指针。
nTabOrigin
指定tab开始展开点的X 逻辑坐标。
str
包含指定字符的CString对象。
说明:
调用该成员函数在指定位置上书写字符串并使用制表键停顿位置数组中的值进行展开。文本使用当前选定的字体书写,如果nTabPositions为0且lpnTabStopPositions为NULL,制表键按平均字符宽度的8倍来进行展开。如果nTabPositions为1,制表键停顿就会受到隔离,其距离是由lpnTabStopPositions指向的数组中的第一个值所指定的。如果lpnTabStopPositions指向多个值,在数组中为每一个值设置一个制表键停顿,一直到nTabPositions指定的数目为止。nTabOrigin参数允许应用对一单行多次调用TabbedTextOut函数。如果应用多次调用nTabOrigin设置为同一值的函数,函数将展开所有的制表位,相对位置由nTabOrigin指定。缺省地,函数不使用或更新当前位置。在调用函数时,如果需要更新当前位置,应用调用nFlags设置为TA_UPDATECP的函数。当该标记设定之后,Windows 覆盖随后调用的TabbedTextOut中的x和y参数,而使用当前位置。
请参阅:
CDC::GetTabbedTextExtent
,
CDC::SetTextAlign
,
CDC::TextOut
,
CDC::SetTextColor
, ::TabbedTextOut ,
CSize