Função DrawThemeBackgroundEx (uxtheme.h)

[DrawThemeBackgroundEx está disponível para uso na operação

sistemas especificados na seção Requisitos. Ele pode estar alterado ou indisponível no

versões subsequentes.]

Desenha a imagem de plano de fundo definida pelo estilo visual para a parte de controle especificada.

Sintaxe

HRESULT DrawThemeBackgroundEx(
  [in] HTHEME         hTheme,
  [in] HDC            hdc,
  [in] int            iPartId,
  [in] int            iStateId,
  [in] LPCRECT        pRect,
  [in] const DTBGOPTS *pOptions
);

Parâmetros

[in] hTheme

Tipo: HTHEME

Manipule para os dados de tema especificados de uma janela. Use OpenThemeData para criar um HTHEME.

[in] hdc

Tipo: HDC

HDC usado para desenhar a imagem de plano de fundo definida pelo tema.

[in] iPartId

Tipo: int

Valor do tipo int que especifica a parte a ser desenhada. Consulte Partes e Estados.

[in] iStateId

Tipo: int

Valor do tipo int que especifica o estado da parte a ser desenhada. Consulte Partes e Estados.

[in] pRect

Tipo: const RECT*

Ponteiro para uma estrutura RECT que contém o retângulo, em coordenadas lógicas, em que a imagem de plano de fundo é desenhada.

[in] pOptions

Tipo: const DTBGOPTS*

Ponteiro para uma estrutura DTBGOPTS que contém informações de recorte. Esse parâmetro pode ser definido como NULL.

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

As operações de desenho são dimensionadas para ajustar e não exceder o retângulo especificado em pRect.

Requisitos

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