CDC::TextOut

使用当前选定的字体在指定位置写入字符串。

virtual BOOL TextOut( 
   int x, 
   int y, 
   LPCTSTR lpszString, 
   int nCount  
); 
BOOL TextOut( 
   int x,
   int y,
   const CString& str 
);

参数

  • x
    指定文本起点的逻辑 x 坐标。

  • y
    指定文本起点的逻辑 y 坐标。

  • lpszString
    指向要绘制的字符串。

  • nCount
    指定字符串中的字符数。

  • str
    包含要绘制的字符的 CString 对象。

返回值

如果该函数成功,则为非 0;否则为 0。

备注

字符原点位于字符单元格的左上角。 默认情况下,函数不使用或更新当前位置。

如果应用程序调用 TextOut 时需要更新当前位置,则该应用程序可以调用 nFlags 设置为 TA_UPDATECPSetTextAlign 成员函数。 该标志设置后,Windows 将在随后的 TextOut 调用中忽略 xy 参数,而是使用当前位置。

示例

请参阅 CDC::BeginPath 示例。

要求

标头: afxwin.h

请参见

参考

CDC 类

层次结构图

CDC::ExtTextOut

CDC::GetTextExtent

CDC::SetTextAlign

CDC::SetTextColor

CDC::TabbedTextOut

TextOut