Función GetThemeBitmap (uxtheme.h)

  • Artículo

Recupera el mapa de bits asociado a un tema, parte, estado y propiedad determinados.

Sintaxis

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

Parámetros

[in] hTheme

Tipo: HTHEME

Identificador de los datos del tema.

[in] iPartId

Tipo: int

Elemento que contiene el mapa de bits. Vea Partes y estados.

[in] iStateId

Tipo: int

Estado de la parte.

[in] iPropId

Tipo: int

Propiedad para recuperar. Pase cero para seleccionar automáticamente el primer mapa de bits disponible para esta parte y estado, o use uno de los siguientes valores.

Valor Significado
TMT_DIBDATA
 Imagen de fondo.
TMT_GLYPHDIBDATA
 Imagen del glifo dibujada sobre el fondo, si está presente.
TMT_HBITMAP
 Actualmente no se admite.

[in] dwFlags

Tipo: ULONG

Marcas que especifican cómo se va a recuperar el mapa de bits. Puede ser uno de los siguientes valores.

Valor Significado
GBF_DIRECT
 Recupera un identificador para el mapa de bits existente.
GBF_COPY
 Recupera una copia del mapa de bits.
GBF_VALIDBITS
 | GBF_DIRECTGBF_COPY

[out] phBitmap

Tipo: HBITMAP*

Puntero que recibe un identificador para el mapa de bits solicitado.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Si dwFlags se establece en GBF_COPY, libere el mapa de bits almacenado en phBitmap cuando ya no lo necesite llamando a DeleteObject.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uxtheme.h
Library UxTheme.lib
Archivo DLL UxTheme.dll