Função GetThemeBackgroundContentRect (uxtheme.h)

Recupera o tamanho da área de conteúdo para a tela de fundo definida pelo estilo visual.

Sintaxe

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

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 a área de conteúdo. Consulte Partes e Estados.

[in] iStateId

Tipo: int

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

[in] pBoundingRect

Tipo: LPCRECT

Ponteiro para uma estrutura RECT que contém o retângulo de plano de fundo total, em coordenadas lógicas. Essa é a área dentro das bordas ou margens.

[out] pContentRect

Tipo: LPRECT

Ponteiro para uma estrutura RECT que recebe o retângulo em segundo plano da área de conteúdo, em coordenadas lógicas. Esse retângulo é calculado para se ajustar à área de conteúdo.

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

Um estilo visual 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.

Exemplos

Ao aplicar um tema a uma área inteira do cliente de uma janela, você pode chamar GetClientRect para recuperar essa área em um RECT, que pode ser passado por meio do ponteiro como o parâmetro pContentRect para GetThemeBackgroundContentRect como no exemplo a seguir.

DWORD resultFlags = GetThemeAppProperties();
bool ctrlsAreThemed = ((resultFlags & STAP_ALLOW_CONTROLS) != 0);

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

GetThemeBackgroundExtent

Identificadores de propriedade

Referência