Share via

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

  • Статья

Извлекает растровое изображение, связанное с определенной темой, частью, состоянием и свойством.

Синтаксис

HRESULT GetThemeBitmap(
  [in]  HTHEME  hTheme,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  int     iPropId,
  [in]  ULONG   dwFlags,
  [out] HBITMAP *phBitmap
);

Параметры

[in] hTheme

Тип: HTHEME

Дескриптор данных темы.

[in] iPartId

Тип: int

Часть, содержащая растровое изображение. См . раздел Части и состояния.

[in] iStateId

Тип: int

Состояние части.

[in] iPropId

Тип: int

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

Значение Значение
TMT_DIBDATA
 Фоновое изображение.
TMT_GLYPHDIBDATA
 Изображение глифа, нарисованное поверх фона, если оно присутствует.
TMT_HBITMAP
 Не поддерживается в текущей версии.

[in] dwFlags

Тип: ULONG

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

Значение Значение
GBF_DIRECT
 Извлекает дескриптор существующего растрового изображения.
GBF_COPY
 Извлекает копию растрового рисунка.
GBF_VALIDBITS
 | GBF_DIRECTGBF_COPY

[out] phBitmap

Тип: HBITMAP*

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

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

Тип: HRESULT

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

Комментарии

Если параметру dwFlags присвоено значение GBF_COPY, отпустите растровое изображение, хранящееся в phBitmap , когда оно больше не требуется, вызвав Метод DeleteObject.

Требования

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