Microsoft Foundation Classes (mfc.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
CDC::TextOut
CDC                                         Up Contents Index Back
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  BOOL TextOut( int x, int y, const char FAR* lpString, int nCount );
  BOOL TextOut( int x, int y, const CString& str );
 
  Parameter   Description
 
  <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
 
 
                                     -♦-