Função GetThemeBackgroundExtent (uxtheme.h)

Calcula o tamanho e o local da tela de fundo, definidos pelo estilo visual, dada a área de conteúdo.

Sintaxe

HRESULT GetThemeBackgroundExtent(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCRECT pContentRect,
  [out] LPRECT  pExtentRect
);

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 a ser usado ao desenhar. Esse parâmetro pode ser definido como NULL.

[in] iPartId

Tipo: int

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

[in] iStateId

Tipo: int

Valor do tipo int que especifica o estado da parte que contém o conteúdo. Consulte Partes e Estados.

[in] pContentRect

Tipo: LPCRECT

Ponteiro para uma estrutura RECT que contém o retângulo em segundo plano de conteúdo, em coordenadas lógicas. Esse retângulo é retornado de GetThemeBackgroundContentRect.

[out] pExtentRect

Tipo: LPRECT

Ponteiro para uma estrutura RECT que recebe o retângulo em segundo plano, em coordenadas lógicas. Esse retângulo é baseado no pContentRect.

Valor retornado

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

Um tema pode definir uma área de conteúdo em cada imagem de plano de fundo. Essa é a área em que o conteúdo, como texto e ícones, pode ser colocado sem substituir bordas de plano de fundo.

Requisitos

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

GetThemeBackgroundContentRect

Identificadores de propriedade

Referência