CDC::DrawText 

Виртуальный int DrawText ( LPCTSTR lpszString, int nCount, LPRECT lpRect, UINT nFormat );

int Dr&awText (const CStringamp;улLPRECTlpRectUINTnFormat );

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

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

Параметры

lpszString

Указывает на строку можно сделать. Если nCount является –1, строка должна быть нулем.

nCount

Задает количество символов в строке. Если nCount является –1, затем lpszString предполагается что длинный указатель на ограниченную значением null строку и DrawText автоматически вычисляет количество символов.

lpRect

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

ул

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

nFormat

Определяет способ форматирования текста. Она может быть любым сочетанием следующих значений (в сочетании с помощью побитового оператора OR):

• DT_BOTTOMnbsp;  Определяет текст оправданным снизу. Это значение должно сочетаться с DT_SI&NGLELINE.
  
  
• DT_CALCRECT   Определяет ширину и высоту прямоугольника. Если существует несколько строк текста, DrawText использовать ширину прямоугольника, который указывает lpRect и расширять базу прямоугольника связанным последней строки текста. Если существует только одна строка текста, DrawText будет изменить с правой стороны прямоугольника таким образом, чтобы он ограничивает последний символ в строке. В любом случае DrawText Возвращает высоту форматированного текста, но не рисовать текст.
  
  
• DT_CE&NTERnbsp;  Центрирует текст по горизонтали.
  
  
• DT_E&ND_ELLIPSIS или DT_PATH_ELLIPSISnbsp;Заменяет часть заданной строки многоточие, при необходимости, результат не умещается в заданном прямоугольнике. Заданной строки не изменяется, если не указан флаг DT_MODIFYSTRING.

  Можно указать DT_END_ELLIPSIS для замены символов в конце строки или DT_PATH_ELLIPSIS для замены символов в середине строки. Если строка содержит символы обратной косой черты (\), DT_PATH_ELLIPSIS сохраняет как можно больше текста после последней обратной косой черты.

• DT_EXPA&NDTABSnbsp;  Расширяет символы табуляции. Количество символов на вкладке по умолчанию-8.
  
  
• DT_EXTER&NALLEADINGnbsp;  Включает Внешнее межстрочное шрифта в высоту строки. Как правило Внешнее межстрочное не входит в высоту строки текста.
  
  
• DT_LEFT   Выравнивает текст флеш слева.
  
  
• DT_MODIFYSTRI&NGnbsp;Изменяет заданную строку для соответствия отображаемого текста. Этот флаг не работает, если не указан флаг DT_END_ELLIPSIS или DT_PATH_ELLIPSIS.

  Примечание Некоторые комбинации флаг uFormat может привести к переданной строки изменяемой. Использование DT_MODIFYSTRING с DT_END_ELLIPSIS или DT_PATH_ELLIPSIS может привести к строке, чтобы изменить, вызывая утверждение в CString переопределения.

• DT_&NOCLIPnbsp;  Выполняет прорисовку без усечения. DrawText несколько быстрее при использовании DT_NOCLIP.
  
  
• DT_NOPREFIXnbsp;  Отключение обработки символов префикса. Как правило, DrawText интерпретирует мнемоник префикса амперсанда (&) как указание подчеркнуть знаку, который следует и двух амперсанд (& &) мнемоник префикса символы как указание напечатать один амперсанд. Задавая DT_NOPREFIX, эта обработка отключена.
  
  
• DT_PATH_ELLIPSISnbsp; & nbsp;
  
  
• DT_RIGHT   Выравнивает текст флеш право.
  
  
• DT_SI&NGLELINEnbsp;  Определяет одну строку. Символы возврата каретки и символов переноса строк не нарушают линию.
  
  
• DT_TABSTOP   Установка позиций табуляции. Старший байт nFormat — количество символов для каждой вкладки. Количество символов на вкладке по умолчанию-8.
  
  
• DT_TOP   Определяет топ оправдано текст (одинарная линия).
  
  
• DT_VCE&NTERnbsp;  Определяет текст вертикально по центру (только одну строку).
  
  
• DT_WORDBREAK   Определяет разбиение. Строки автоматически разрываются между словами Если слово будет распространяться за край прямоугольника, определяемого lpRect. Последовательность return–linefeed перевозки также разрыв строки.

&Notenbsp;Значения 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.

CDC обзор |  Члены класса | Иерархическая схема

См. такжеnbsp;CDC::SetTextColor, CDC::ExtTextOut, CDC::TabbedTextOut, CDC::TextOut, :: DrawText, RECT, CDC::SetTextAlign