Поделиться через


CDC::TextOut

Записывает символьную строку в указанном месте, используя текущий выбранный шрифт.

virtual BOOL TextOut( 
   int x, 
   int y, 
   LPCTSTR lpszString, 
   int nCount  
); 
BOOL TextOut( 
   int x,
   int y,
   const CString& str 
);

Параметры

  • x
    Указывает логическую координату X начальной точки текста.

  • y
    Указывает логическую координату Y начальной точки текста.

  • lpszString
    Указывает на строку символов, которую необходимо нарисовать.

  • nCount
    Указывает количество знаков в строке.

  • str
    Объект CString, который содержит символы, которые необходимо нарисовать.

Возвращаемое значение

Ненулевое значение, если функция выполнена успешно; в противном случае — 0.

Заметки

Начальные координаты символа в левом верхнем углу ячейки символов. По умолчанию текущая позиция не используется и не обновляется функцией.

Если приложению необходимо обновить текущую позицию во время вызова TextOut, приложение может вызвать функцию-член SetTextAlign со значением TA_UPDATECP для nFlags. Если этот флажок установлен, Windows игнорирует параметры x и y при последующих вызовах TextOut, вместо этого используя текущую позицию.

Пример

См. пример для CDC::BeginPath.

Требования

Заголовок: afxwin.h

См. также

Ссылки

Класс CDC

Диаграмма иерархии

CDC::ExtTextOut

CDC::GetTextExtent

CDC::SetTextAlign

CDC::SetTextColor

CDC::TabbedTextOut

TextOut