Funzione GetThemeBitmap (uxtheme.h)

Recupera la bitmap associata a un particolare tema, parte, stato e proprietà.

Sintassi

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

Parametri

[in] hTheme

Tipo: HTHEME

Handle per i dati del tema.

[in] iPartId

Tipo: int

Parte che contiene la bitmap. Vedere Parti e stati.

[in] iStateId

Tipo: int

Stato della parte.

[in] iPropId

Tipo: int

Proprietà da recuperare. Passare zero per selezionare automaticamente la prima bitmap disponibile per questa parte e lo stato oppure usare uno dei valori seguenti.

Valore	Significato
TMT_DIBDATA	Immagine di sfondo.
TMT_GLYPHDIBDATA	Immagine del glifo disegnata sopra lo sfondo, se presente.
TMT_HBITMAP	Non è attualmente supportato.

[in] dwFlags

Tipo: ULONG

Flag che specificano la modalità di recupero della bitmap. Può essere uno dei valori seguenti.

Valore	Significato
GBF_DIRECT	Recupera un handle nella bitmap esistente.
GBF_COPY	Recupera una copia della bitmap.
GBF_VALIDBITS	| GBF_DIRECTGBF_COPY

[out] phBitmap

Tipo: HBITMAP*

Puntatore che riceve un handle per la bitmap richiesta.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se dwFlags è impostato su GBF_COPY, rilasciare la bitmap archiviata in phBitmap quando non è più necessaria chiamando DeleteObject.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uxtheme.h
Libreria	UxTheme.lib
DLL	UxTheme.dll