Функция DrawTextEx отрисовывает форматированный текст в указанном прямоугольнике.

int DrawTextEx(
    HDC hdc,	// дескриптор контекста устройства
    LPTSTR lpchText,	// адрес рисуемой строки
    int cchText,	// длина строки
    LPRECT lprc,	// адрес координат прямоугольника
    UINT dwDTFormat,	// опции форматирования
    LPDRAWTEXTPARAMS lpDTParams	// адерес структуры с дополнительными опциями
   );

Параметры:

hdc	Определяет контекст устройства для рисования в нем.
lpchText	Адрес строки для ее прорисовки. Строка должна заканчиваться нулем, если параметр cchText равен -1.
cchText	Указывает размер, в символах, строки lpchText. Если строка заканчивается нулем, этот параметр может быть -1 для подсчета длины.
lprc	Адрес структуры RECT, которая содержит прямоугольник, в логических координатах, в котором будет форматироваться текст.
dwDTFormat	Определяет опции форматирования. Этот параметр может принимать одно или комбинацию из этих значений: Значение: Описание: DT_BOTTOM Выравнивает текст к основанию прямоугольника, используется только со значеним DT_SINGLELINE. DT_CALCRECT Определяет ширину и высоту прямоугольника. Если имеется несколько строк текста, функция использует ширину прямоугольника, указанного в параметре lprc, и расширяет прямоугольник для включения последней строки текста. Если имеется только одна строка текста, функция изменяет правую сторону прямоугольника для включения в него последнего символа строки. В любом случае функция возвращает высоту отформатированного текста, не не выводит текст. DT_CENTER Центрирует текст горизонтально в прямоугольнике. DT_EDITCONTROL Дублирует характеристики многострочного средства редактирования. DT_END_ELLIPSIS или DT_PATH_ELLIPSIS Перемещает часть строки с элипсом, если необходимо, так что результат заполняет указанный прямоугольник. Строка не модифицируется без указанного флага DT_MODIFYSTRING. Вы можете указать DT_END_ELLIPSIS для перемещения символов в конец строки, или DT_PATH_ELLIPSIS для перемещения символов в середину строки. Если строк содержит обратный слеш (\), DT_PATH_ELLIPSIS сохраняет сколько возможно текста после последнего обратного слеша. DT_EXPANDTABS Разворачивает символы табуляции. По умолчанию, в символе табуляции задано 8 символов. DT_EXTERNALLEADING Включает внешний шрифт в формировании высоты строки. DT_LEFT Выравнивает текст по левую сторону. DT_MODIFYSTRING Изменяет указанную строку для соответствия отображаемому тексту. Это значение не имеет эффекта без определения флага DT_END_ELLIPSIS или DT_PATH_ELLIPSIS. DT_NOCLIP Выводит текст без отсечения. DrawTextEx иногда работает быстрее, если определен этот флаг. DT_NOPREFIX Выключает отработку префиксных символов (таких, как & и &&). DT_RIGHT Выравнивает текст по правую сторону. DT_RTLREADING Устанавливает обратный порядок чтения, используемые в арабском и еврейском языках. DT_SINGLELINE Отображает текст только в одной строке. DT_TABSTOP Устанавливает символы табуляции. Структура DRAWTEXTPARAMS, на которую указывает параметр lpDTParams, поределяет число средней длины символов табуляции. DT_TOP Выравнивает текст по верху (только однострочный). DT_VCENTER Выравнивает текст вертикально (только однострочный). DT_WORDBREAK Разрывает слова при переносе.
dwDTParams	Адрес структуры DRAWTEXTPARAMS, которая определяет дополнительные опции форматирования. Этот параметр может быть равен NULL.

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

Если вызов функции успешен, возвращается высота текста.
При ошибке возвращается ноль.

Смотрите также: