CDC::TextOut

Syntax

BOOL TextOut( int x, int y, const char FAR* lpString, 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.

lpString

The pointer to the characters to write.

nCount

Specifies the number of characters to write.

str

A CString object or null-terminated string that contains the chararacters to write.

Remarks

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

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 SetTextAlign with nFlags set to TA_UPDATECP. When this flag is set, Windows ignores x and y on subsequent calls to TextOut, using the current position instead.

Return Value

TRUE if the function is successful; otherwise FALSE.

See Also

CDC::ExtTextOut, CDC::GetTextExtent, CDC::SetTextAlign, CDC::SetTextColor, CDC::TabbedTextOut, ::TextOut