CDC::TabbedTextOut

项目
03/01/2013

调用该成员函数编写字符字符串在指定的位置，展开切换到在指定的值制表位位置。

virtual CSize TabbedTextOut(
   int x,
   int y,
   LPCTSTR lpszString,
   int nCount,
   int nTabPositions,
   LPINT lpnTabStopPositions,
   int nTabOrigin 
);
CSize TabbedTextOut(
   int x,
   int y,
   const CString& str,
   int nTabPositions,
   LPINT lpnTabStopPositions,
   int nTabOrigin 
);

参数

x
指定的逻辑x坐标开始该字符串。
y
指定的逻辑y坐标开始该字符串。
lpszString
指向字符字符串绘制。通过指向一个字符数组或此参数的 CString 对象。
nCount
在字符串指定字符数。如果 nCount 为– 1，则长度计算。
nTabPositions
在指定值的数量制表位位置。
lpnTabStopPositions
指向包含制表位位置的数组(以逻辑单位）。以递增的顺序必须排序选项停止;最小x值应为该数组中的第一项。
nTabOrigin
指定选项展开起始位置的x坐标(以逻辑单位）。
str
包含指定字符的 CString 对象。

返回值

字符串的尺寸(以逻辑单位)作为 CSize 对象。

备注

文本在当前选定的字体编写。如果 nTabPositions 为0，并 lpnTabStopPositions 是 NULL选项，展开为八次平均字符宽度。

如果 nTabPositions 为1，制表位由第一个值指定的距离分隔。lpnTabStopPositions 数组。如果 lpnTabStopPositions 数组包含多个值，制表位为该数组中的每个值设置，到 nTabPositions指定的数字。 nTabOrigin 参数允许应用程序调用 TabbedTextOut 函数一行中多次。如果应用程序多次调用函数 nTabOrigin 每次设置为同一个值，该函数展开所有选项相对 nTabOrigin指定的该位置。

默认情况下，当前位置不使用或函数不更新。如果应用程序需要更新当前位置，在调用函数时，应用程序可以调用与 nFlags 的 SetTextAlign 成员函数设置为 TA_UPDATECP。在此标志设置为时，Windows忽略该 x，并在的 y 参数的后续调用 TabbedTextOut，则使用当前位置。