Compartilhar via


Função HitTestThemeBackground (uxtheme.h)

Recupera um código de teste de ocorrência para um ponto em segundo plano especificado por um estilo visual.

Sintaxe

HRESULT HitTestThemeBackground(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  DWORD   dwOptions,
  [in]  LPCRECT pRect,
  [in]  HRGN    hrgn,
  [in]  POINT   ptTest,
  [out] WORD    *pwHitTestCode
);

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. Consulte Partes e Estados.

[in] iStateId

Tipo: int

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

[in] dwOptions

Tipo: DWORD

DWORD que especifica as opções de teste de ocorrência. Consulte Opções de Teste de Clique para obter uma lista de opções.

[in] pRect

Tipo: LPCRECT

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

[in] hrgn

Tipo: HRGN

Manipule para uma região que pode ser usada para especificar os limites de uma área de teste de ocorrência. Esse parâmetro pode ser definido como NULL.

[in] ptTest

Tipo: POINT

Estrutura POINT que contém as coordenadas do ponto.

[out] pwHitTestCode

Tipo: WORD*

WORD que recebe o código de teste de ocorrência que indica se o ponto em ptTest está na área de fundo limitada por pRect ou hrgn. Confira Valores retornados do Teste de Ocorrência para obter uma lista de valores retornados.

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

Os valores em ptTest e pRect devem estar no mesmo sistema de coordenadas, como cliente ou tela. Se o parâmetro hrgn for usado, ele deverá ser especificado nas mesmas coordenadas que pRect e ptTest.

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