Freigeben über

GetThemeBitmap-Funktion (uxtheme.h)

  • Artikel

Ruft die Bitmap ab, die einem bestimmten Design, einem bestimmten Teil, einem bestimmten Zustand und einer bestimmten Eigenschaft zugeordnet ist.

Syntax

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

Parameter

[in] hTheme

Typ: HTHEME

Ein Handle für Designdaten.

[in] iPartId

Typ: int

Der Teil, der die Bitmap enthält. Weitere Informationen finden Sie unter Teile und Zustände.

[in] iStateId

Typ: int

Der Zustand des Teils.

[in] iPropId

Typ: int

Die abzurufende Eigenschaft. Übergeben Sie null, um automatisch die erste verfügbare Bitmap für diesen Teil und Zustand auszuwählen, oder verwenden Sie einen der folgenden Werte.

Wert Bedeutung
TMT_DIBDATA
 Das Hintergrundbild.
TMT_GLYPHDIBDATA
 Das auf dem Hintergrund gezeichnete Glyphenbild, falls vorhanden.
TMT_HBITMAP
 Wird derzeit nicht unterstützt.

[in] dwFlags

Typ: ULONG

Die Flags, die angeben, wie die Bitmap abgerufen werden soll. Kann einer der folgenden Werte sein.

Wert Bedeutung
GBF_DIRECT
 Ruft ein Handle für die vorhandene Bitmap ab.
GBF_COPY
 Ruft eine Kopie der Bitmap ab.
GBF_VALIDBITS
 | GBF_DIRECTGBF_COPY

[out] phBitmap

Typ: HBITMAP*

Ein Zeiger, der ein Handle auf die angeforderte Bitmap empfängt.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn dwFlags auf GBF_COPY festgelegt ist, geben Sie die in phBitmap gespeicherte Bitmap frei, wenn sie nicht mehr benötigt wird, indem Sie DeleteObject aufrufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uxtheme.h
Bibliothek UxTheme.lib
DLL UxTheme.dll