Compartilhar via


Função DrawThemeBackground (uxtheme.h)

Desenha a borda e o preenchimento definidos pelo estilo visual para a parte de controle especificada.

Sintaxe

HRESULT DrawThemeBackground(
  [in] HTHEME  hTheme,
  [in] HDC     hdc,
  [in] int     iPartId,
  [in] int     iStateId,
  [in] LPCRECT pRect,
  [in] LPCRECT pClipRect
);

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] pClipRect

Tipo: const RECT*

Ponteiro para uma estrutura RECT que contém um retângulo 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 caber e não excedem o retângulo especificado em pRect. Seu aplicativo não deve desenhar fora do retângulo especificado por pClipRect.

Exemplos

Antes de chamar DrawThemeBackground para desenhar a imagem de plano de fundo de uma janela, você pode chamar IsThemeBackgroundPartiallyTransparent. Esse método determina se DrawThemeParentBackground deve ser chamado para desenhar em segundo plano por trás de controles filho parcialmente transparentes ou combinados alfa e é demonstrado no exemplo a seguir.

if (_hTheme)
{
  if (IsThemeBackgroundPartiallyTransparent(_hTheme, BP_PUSHBUTTON, _iStateId))
  {
    DrawThemeParentBackground(_hwnd, hdcPaint, prcPaint);
  }

  DrawThemeBackground(_hTheme,
                    hdcPaint,
                    BP_PUSHBUTTON,
                    _iStateId,
                    &rcClient,
                    prcPaint);
}

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

Confira também

Identificadores de propriedade