Compartilhar via


Função GetThemeBackgroundRegion (uxtheme.h)

Calcula a região para uma tela de fundo regular ou parcialmente transparente que é limitada por um retângulo especificado.

Sintaxe

HRESULT GetThemeBackgroundRegion(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCRECT pRect,
  [out] HRGN    *pRegion
);

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 para desenhar. O DC usa o dimensionamento de pontos por polegada (DPI). Esse parâmetro pode ser definido como NULL.

[in] iPartId

Tipo: int

Valor do tipo int que especifica a parte que contém a região. Consulte Partes e Estados.

[in] iStateId

Tipo: int

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

[in] pRect

Tipo: LPCRECT

Ponteiro para uma estrutura RECT que contém, em coordenadas lógicas, o retângulo especificado usado para calcular a região.

[out] pRegion

Tipo: HRGN*

Ponteiro para o identificador para a região computada.

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

O identificador de região retornado por essa função deve ser liberado quando não for mais necessário, usando DeleteObject.

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

Outros recursos

Identificadores de propriedade

Referência

Regiões