Condividi tramite

Funzione GetThemeBitmap (uxtheme.h)

  • Articolo

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