Share via

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

  • Статья

Извлекает значение свойства метрики.

Синтаксис

HRESULT GetThemeMetric(
  [in]  HTHEME hTheme,
  [in]  HDC    hdc,
  [in]  int    iPartId,
  [in]  int    iStateId,
  [in]  int    iPropId,
  [out] int    *piVal
);

Параметры

[in] hTheme

Тип: HTHEME

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

[in] hdc

Тип: HDC

HDC. Для этого параметра может быть задано значение NULL.

[in] iPartId

Тип: int

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

[in] iStateId

Тип: int

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

[in] iPropId

Тип: int

Значение типа int , указывающее извлекаемое свойство. Может иметь одно из следующих значений.

Значение Значение
TMT_ALPHALEVEL
 Альфа-значение (0–255), используемое для DrawThemeIcon.
TMT_ALPHATHRESHOLD
 Минимальное альфа-значение (0–255), которое пиксель должен считаться непрозрачным.
TMT_BORDERSIZE
 Толщина границы, нарисованной, если в этой части используется заливка границы.
TMT_GLYPHINDEX
 Индекс символа в выбранном шрифте, который будет использоваться для глифа, если часть использует глиф на основе шрифта.
TMT_GRADIENTRATIO1
 Объем первого цвета градиента, используемого при рисовании части. Это значение может быть от 0 до 255, но это значение плюс значения каждого значения GRADIENTRATIO должны добавить до 255. См. TMT_GRADIENTCOLOR1 значение GetThemeColor.
TMT_GRADIENTRATIO2
 Объем второго цвета градиента, используемого при рисовании части.
TMT_GRADIENTRATIO3
 Объем третьего цвета градиента, используемого при рисовании части.
TMT_GRADIENTRATIO4
 Величина четвертого цвета градиента, используемого при рисовании части.
TMT_GRADIENTRATIO5
 Количество пятого цвета градиента, используемого при рисовании части.
TMT_HEIGHT
 Высота части.
TMT_IMAGECOUNT
 Количество изображений состояний, присутствующих в файле образа.
TMT_MINDPI1
 Минимальное число точек на дюйм, для которое был разработан первый файл изображения. См . раздел GetThemeFilename.
TMT_MINDPI2
 Минимальное разрешение на дюйм, для которому был разработан второй файл изображения.
TMT_MINDPI3
 Минимальное разрешение на дюйм, для который был разработан третий файл изображения.
TMT_MINDPI4
 Минимальное число точек на дюйм, для использования в четвертом файле изображения.
TMT_MINDPI5
 Минимальное разрешение на дюйм, для которому был разработан пятый файл изображения.
TMT_PROGRESSCHUNKSIZE
 Размер фигур элемента управления "ход выполнения", определяющих, насколько далеко выполнена операция.
TMT_PROGRESSSPACESIZE
 Общий размер всех "блоков" элемента управления "ход выполнения".
TMT_ROUNDCORNERWIDTH
 Округлость (0–100 %) углов части.
TMT_ROUNDCORNERHEIGHT
 Округлость (0–100 %) углов части.
TMT_SATURATION
 Величина насыщенности (0–255), применяемая к значку, нарисованного с помощью DrawThemeIcon.
TMT_TEXTBORDERSIZE
 Толщина границы, нарисованной вокруг текстовых символов.
TMT_TRUESIZESTRETCHMARK
 Процент исходного размера изображения истинного размера, при котором изображение будет растянуто.
TMT_WIDTH
 Ширина части.

[out] piVal

Тип: int*

Указатель на int , получающий значение свойства метрики.

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

Тип: HRESULT

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

Требования

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

См. также раздел

Идентификаторы свойств