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

Parameters

  • 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 bytes in the string.

  • str
    A CString object that contains the characters to be drawn.

Return Value

Nonzero if the function is successful; otherwise 0.

Remarks

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.

Example

See the example for CDC::BeginPath.

Requirements

Header: afxwin.h

See Also

Reference

CDC Class

Hierarchy Chart

CDC::ExtTextOut

CDC::GetTextExtent

CDC::SetTextAlign

CDC::SetTextColor

CDC::TabbedTextOut

TextOut

Other Resources

CDC Members