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

Функция DrawThemeTextEx (uxtheme.h)

  • Статья

Рисует текст с использованием цвета и шрифта, определенных визуальным стилем. Расширяет возможности DrawThemeText , разрешая дополнительные параметры форматирования текста.

Синтаксис

HRESULT DrawThemeTextEx(
  [in]      HTHEME        hTheme,
  [in]      HDC           hdc,
  [in]      int           iPartId,
  [in]      int           iStateId,
  [in]      LPCWSTR       pszText,
  [in]      int           cchText,
  [in]      DWORD         dwTextFlags,
  [in, out] LPRECT        pRect,
  [in]      const DTTOPTS *pOptions
);

Параметры

[in] hTheme

Тип: HTHEME

Обработка данных указанной темы окна. Используйте OpenThemeData для создания HTHEME.

[in] hdc

Тип: HDC

HDC для рисования.

[in] iPartId

Тип: int

Часть элемента управления, имеющая нужный вид текста. См. раздел Части и состояния. Если это значение равно 0, текст рисуется с помощью шрифта по умолчанию или шрифта, выбранного в контексте устройства.

[in] iStateId

Тип: int

Состояние элемента управления, имеющее нужный вид текста. См. раздел Части и состояния.

[in] pszText

Тип: LPCWSTR

Указатель на строку, содержащую текст для рисования.

[in] cchText

Тип: int

Значение типа int , содержащее количество символов для рисования. Если параметр имеет значение -1, то рисуются все символы в строке.

[in] dwTextFlags

Тип: DWORD

DWORD , содержащий одно или несколько значений, определяющих форматирование строки. Возможные значения параметров см. в разделе Форматирование значений.

[in, out] pRect

Тип: LPRECT

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

[in] pOptions

Тип: const DTTOPTS*

Структура DTTOPTS , которая определяет дополнительные параметры форматирования, которые будут применяться к отрисовываемму тексту.

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

Тип: HRESULT

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Функция всегда использует тематический шрифт для указанной части и состояния, если он определен. В противном случае используется шрифт, выбранный в настоящее время в контексте устройства. Чтобы узнать, определен ли тематический шрифт, можно вызвать Метод GetThemeFont или GetThemePropertyOrigin с TMT_FONT в качестве идентификатора свойства.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header uxtheme.h
Библиотека UxTheme.lib
DLL UxTheme.dll