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


CDC::DrawText

Эта функция-член вызывается, чтобы отформатировать текст в заданном прямоугольнике. Чтобы задать дополнительные параметры форматирования используется CDC::DrawTextEx.

virtual int DrawText( 
   LPCTSTR lpszString, 
   int nCount, 
   LPRECT lpRect, 
   UINT nFormat  
); 
int DrawText( 
   const CString& str, 
   LPRECT lpRect, 
   UINT nFormat  
);

Параметры

  • lpszString
    Указывает на строке для рисования. Если nCount 1, то строка должна быть null- завершения.

  • nCount
    Указывает число char в строке. Если nCount –, то предполагается, что 1, lpszString длинным указателем на строку null- завершенной и DrawText вычисляет количество символов автоматически.

  • lpRect
    Указывает на RECT составляющих или объект CRect, содержащий прямоугольник (в логических координатах текст, в котором используются.

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

  • nFormat
    Определяет метод форматирования текста. Может быть любым сочетанием значения описали для параметра uFormat в DrawText в Windows SDK. Комбинируется с помощью оператора (побитовое ИЛИ):

    Примечание

    Пометить uFormat могут привести к тому, что некоторые сочетания методов передачу строку быть изменено.Использование DT_MODIFYSTRING с DT_END_ELLIPSIS или DT_PATH_ELLIPSIS может привести к строке быть изменено, что утверждение в переопределенном методе CString.Значения DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIP и DT_NOPREFIX нельзя использовать со значением DT_TABSTOP.

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

Высота текста если функция успешно.

Заметки

Это форматирует текст с развернуть вкладки в соответствующие пространства, выравнивая текста в левого, правого или центре заданного прямоугольника и является текст в линии то совпадение в заданном прямоугольнике. Тип форматирования указан nFormat.

Эта функция-член использует шрифт, цвет текста и цвет фона контекста устройства, выбранный для отрисовки текста. Если формат DT_NOCLIP не используется, DrawText отсекает текст, так что текст не будет отображаться за пределами заданным прямоугольником. Предполагается, что имеется несколько все форматирование линий, если формат DT_SINGLELINE не дастся.

Если выбранный шрифт слишком велик для указанного прямоугольника, DrawText функция-член не пытается заменить меньший шрифт.

Если пометить DT_CALCRECT указан, то прямоугольник указанный lpRect будет обновить, чтобы отразить ширина и высота, необходимые для отрисовки текста.

Если был установлен пометить текст- выравнивания TA_UPDATECP (см. CDC::SetTextAlign), то DrawText отображает текст, начиная с текущей позиции, а не с левой стороны заданного прямоугольника. DrawText не создает программу-оболочку текст, если пометить TA_UPDATECP будет установлен (то есть пометить DT_WORDBREAK не будет иметь эффекта).

Цвет текста может быть установлен CDC::SetTextColor.

Требования

Header: afxwin.h

См. также

Ссылки

Класс CDC

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

CDC::SetTextColor

CDC::ExtTextOut

CDC::TabbedTextOut

CDC::TextOut

DrawText

Структура RECT

CDC::SetTextAlign