CDC::DrawText

Статья
02/20/2013

Эта функция-член вызывается, чтобы отформатировать текст в заданном прямоугольнике.Чтобы задать дополнительные параметры форматирования используется 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.

Пометить 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.