Função GetThemeBitmap (uxtheme.h)

  • Artigo

Recupera o bitmap associado a um tema, parte, estado e propriedade específicos.

Sintaxe

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

Um identificador para os dados do tema.

[in] iPartId

Tipo: int

A parte que contém o bitmap. Consulte Partes e Estados.

[in] iStateId

Tipo: int

O estado da parte.

[in] iPropId

Tipo: int

Propriedade a recuperar. Passe zero para selecionar automaticamente o primeiro bitmap disponível para esta parte e estado ou use um dos valores a seguir.

Valor Significado
TMT_DIBDATA
 A imagem de plano de fundo.
TMT_GLYPHDIBDATA
 A imagem de glifo desenhada na parte superior da tela de fundo, se presente.
TMT_HBITMAP
 Sem suporte no momento.

[in] dwFlags

Tipo: ULONG

Os sinalizadores que especificam como o bitmap deve ser recuperado. Pode ser um dos valores a seguir.

Valor Significado
GBF_DIRECT
 Recupera um identificador para o bitmap existente.
GBF_COPY
 Recupera uma cópia do bitmap.
GBF_VALIDBITS
 | GBF_DIRECTGBF_COPY

[out] phBitmap

Tipo: HBITMAP*

Um ponteiro que recebe um identificador para o bitmap solicitado.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se dwFlags estiver definido como GBF_COPY, libere o bitmap armazenado em phBitmap quando não for mais necessário chamando DeleteObject.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uxtheme.h
Biblioteca UxTheme.lib
DLL UxTheme.dll