This documentation is archived and is not being maintained.


Writes a character string at the specified location using the currently selected font.

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



Specifies the logical x-coordinate of the starting point of the text.


Specifies the logical y-coordinate of the starting point of the text.


Points to the character string to be drawn.


Specifies the number of bytes in the string.


A CString object that contains the characters to be drawn.

Nonzero if the function is successful; otherwise 0.

Character origins are at the upper-left corner of the character cell. By default, the current position is not used or updated by the function.

If an application needs to update the current position when it calls TextOut, the application can call the SetTextAlign member function with nFlags set to TA_UPDATECP. When this flag is set, Windows ignores the x and y parameters on subsequent calls to TextOut, using the current position instead.

See the example for CDC::BeginPath.