Структура DTTOPTS (uxtheme.h)

Определяет параметры функции DrawThemeTextEx .

Синтаксис

typedef struct _DTTOPTS {
  DWORD             dwSize;
  DWORD             dwFlags;
  COLORREF          crText;
  COLORREF          crBorder;
  COLORREF          crShadow;
  int               iTextShadowType;
  POINT             ptShadowOffset;
  int               iBorderSize;
  int               iFontPropId;
  int               iColorPropId;
  int               iStateId;
  BOOL              fApplyOverlay;
  int               iGlowSize;
  DTT_CALLBACK_PROC pfnDrawTextCallback;
  LPARAM            lParam;
} DTTOPTS, *PDTTOPTS;

Члены

dwSize

Тип: DWORD

Размер структуры.

dwFlags

Тип: DWORD

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

Значение	Значение
DTT_TEXTCOLOR	Допустимое значение элемента crText .
DTT_BORDERCOLOR	Допустимое значение члена crBorder .
DTT_SHADOWCOLOR	Допустимое значение члена crShadow .
DTT_SHADOWTYPE	Допустимое значение члена iTextShadowType .
DTT_SHADOWOFFSET	Допустимое значение члена ptShadowOffset .
DTT_BORDERSIZE	Допустимое значение элемента iBorderSize .
DTT_FONTPROP	Допустимое значение члена iFontPropId .
DTT_COLORPROP	Допустимое значение элемента iColorPropId .
DTT_STATEID	Допустимое значение элемента iStateId .
DTT_CALCRECT	Параметр pRect функции DrawThemeTextEx , которая использует эту структуру, будет использоваться как параметр in и out. После возврата функции параметр pRect будет содержать прямоугольник, соответствующий отрисовке области.
DTT_APPLYOVERLAY	Допустимое значение члена fApplyOverlay .
DTT_GLOWSIZE	Допустимое значение члена iGlowSize .
DTT_CALLBACK	Допустимое значение члена pfnDrawTextCallback .
DTT_COMPOSITED	Рисует текст с помощью сглаживаемого альфа-канала. Для использования этого флага требуется раздел DIB сверху вниз. Этот флаг работает, только если в HDC, переданном функции DrawThemeTextEx , в настоящее время выбран раздел DIB сверху вниз. Дополнительные сведения см. в разделе Точечные изображения, независимые от устройства.
DTT_VALIDBITS	DTT_TEXTCOLOR | DTT_BORDERCOLOR | DTT_SHADOWCOLOR | DTT_SHADOWTYPE | DTT_SHADOWOFFSET | DTT_BORDERSIZE | DTT_FONTPROP | DTT_COLORPROP | DTT_STATEID | DTT_CALCRECT | DTT_APPLYOVERLAY | DTT_GLOWSIZE | DTT_COMPOSITED.

crText

Тип: COLORREF

Указывает цвет нарисованного текста.

crBorder

Тип: COLORREF

Задает цвет контура, который будет нарисован вокруг текста.

crShadow

Тип: COLORREF

Указывает цвет тени, которая будет отрисована за текстом.

iTextShadowType

Тип: int

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

Значение	Значение
TST_NONE	Тень не будет нарисована.
TST_SINGLE	Тень будет отрисована, чтобы она отображалась подробно под текстом.
TST_CONTINUOUS	Тень будет отрисована, чтобы она выглядела размытой под текстом.

ptShadowOffset

Тип: POINT

Задает величину смещения (в логических координатах) между тенью и текстом.

iBorderSize

Тип: int

Указывает радиус контура, который будет нарисован вокруг текста.

iFontPropId

Тип: int

Задает альтернативное свойство шрифта, используемое при рисовании текста. Список возможных значений см . в разделе GetThemeSysFont.

iColorPropId

Тип: int

Задает свойство альтернативного цвета, используемое при рисовании текста. Если это значение допустимо и соответствующий флаг задан в dwFlags, это значение переопределяет значение crText. См. значения, перечисленные в GetSysColor для параметра nIndex .

iStateId

Тип: int

Указывает альтернативное состояние для использования. Этот элемент не используется в DrawThemeTextEx.

fApplyOverlay

Тип: BOOL

Если задано значение TRUE, текст будет нарисован поверх эффектов тени и контура. Если значение FALSE, будут нарисованы только эффекты тени и контура.

iGlowSize

Тип: int

Задает размер свечения, которое будет нарисовано на фоне до рисования текста.

pfnDrawTextCallback

Тип: DTT_CALLBACK_PROC

Указатель на функцию обратного вызова для DrawThemeTextEx.

lParam

Тип: LPARAM

Параметр для функции обратного вызова, заданной pfnDrawTextCallback.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Верхняя часть	uxtheme.h