Export (0) Print
Expand All
Expand Minimize

CDC::TextOut

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 
);

x

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

y

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

lpszString

Points to the character string to be drawn.

nCount

Specifies the number of characters in the string.

str

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

Show:
© 2014 Microsoft