Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Collapse the table of content
Expand the table of content


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 characters 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.

Header: afxwin.h

© 2015 Microsoft