Export (0) Print
Expand All
Expand Minimize


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