Share via

GetThemeBitmap, fonction (uxtheme.h)

  • Article

Récupère l’image bitmap associée à un thème, une partie, un état et une propriété particuliers.

Syntaxe

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

Paramètres

[in] hTheme

Type : HTHEME

Handle pour les données de thème.

[in] iPartId

Type : int

Partie qui contient l’image bitmap. Consultez Parties et états.

[in] iStateId

Type : int

État de la partie.

[in] iPropId

Type : int

Propriétés à récupérer. Passez zéro pour sélectionner automatiquement la première bitmap disponible pour cette partie et cet état, ou utilisez l’une des valeurs suivantes.

Valeur Signification
TMT_DIBDATA
 Image d'arrière-plan.
TMT_GLYPHDIBDATA
 Image de glyphe dessinée au-dessus de l’arrière-plan, le cas échéant.
TMT_HBITMAP
 Non pris en charge actuellement.

[in] dwFlags

Type : ULONG

Indicateurs qui spécifient la façon dont la bitmap doit être récupérée. Il peut s’agir de l’une des valeurs suivantes.

Valeur Signification
GBF_DIRECT
 Récupère un handle dans l’image bitmap existante.
GBF_COPY
 Récupère une copie de l’image bitmap.
GBF_VALIDBITS
 | GBF_DIRECTGBF_COPY

[out] phBitmap

Type : HBITMAP*

Pointeur qui reçoit un handle vers l’image bitmap demandée.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Si dwFlags a la valeur GBF_COPY, relâchez l’image bitmap stockée dans phBitmap lorsqu’elle n’est plus nécessaire en appelant DeleteObject.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête uxtheme.h
Bibliothèque UxTheme.lib
DLL UxTheme.dll