CDC::ExtTextOut

项目
03/01/2013

使用当前选定的字体，调用此成员函数编写在矩形区域内的字符字符串。

virtual BOOL ExtTextOut(
   int x,
   int y,
   UINT nOptions,
   LPCRECT lpRect,
   LPCTSTR lpszString,
   UINT nCount,
   LPINT lpDxWidths 
);
BOOL ExtTextOut(
   int x,
   int y,
   UINT nOptions,
   LPCRECT lpRect,
   const CString& str,
   LPINT lpDxWidths 
);

参数

x
对于第一个字符指定字符格的逻辑x坐标在指定字符串中。
y
对于第一个字符指定字符格的顶部逻辑y坐标在指定字符串中。
nOptions
指定矩形类型。此参数可以是下列值之一，或关闭和/或:
- ETO_CLIPPED 指定文本剪切对矩形。
- ETO_OPAQUE 指定当前背景上颜色矩形。（可将和查询与 SetBkColor 和 GetBkColor 成员函数的当前背景色。）
lpRect
指向 RECT 确定该矩形的尺寸的结构。此参数可以是 NULL。还可以通过此参数的 CRect 对象。
lpszString
指向要绘制的指定字符字符串。还可以通过此参数的 CString 对象。
nCount
在字符串指定字符数。
lpDxWidths
指向字符指示相邻元素之间的原点的距离的值。例如，lpDxWidths[i] 逻辑单元将分隔字符和 i 字符单元格 i> + 1 的原点。如果 lpDxWidths 是 NULL，ExtTextOut 使用在字符之间的默认时间间隔。
str
包含要绘制的指定字符的 CString 对象。

返回值

非零，如果函数运行成功;否则为0。

备注

矩形区域可以是不透明的(用当前背景色填充)，因此，它可以是一个剪辑区域。

如果 nOptions 为0，并 lpRect 是 NULL，函数编写文本到设备上下文，而无需使用矩形区域。默认情况下，当前位置不使用或函数不更新。如果应用程序需要更新当前位置，在调用 ExtTextOut时，应用程序可以调用与 nFlags 的 CDC 成员函数 SetTextAlign 设置为 TA_UPDATECP。在此标志设置为时，Windows忽略 x，并在的 y 的后续调用 ExtTextOut 并使用当前位置。当应用程序使用 TA_UPDATECP 更新当前位置时，ExtTextOut 将当前位置的文本上一行的结尾或对数组的最后一个元素指定的该位置指向由 lpDxWidths，后者会更大。