Compartilhar via

Método IXamlDiagnostics2::HitTestForXamlRoot (xamlom.winui.h)

  • Artigo

Obtém todos os elementos na árvore visual que se enquadram no retângulo especificado.

Sintaxe

HRESULT HitTestForXamlRoot(
  InstanceHandle instanceHandle,
  RECT           rect,
  unsigned int   *pCount,
  InstanceHandle **ppInstanceHandles
);

Parâmetros

instanceHandle

Um identificador para a instância XamlRoot.

rect

A área a ser atingida no teste.

pCount

O número de elementos encontrados.

ppInstanceHandles

Uma matriz que contém todos os elementos encontrados.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ela retornará um código de erro HRESULT.

Comentários

Esse método executa testes de clique para o XamlRoot passado como instanceHandle, dentro dos limites de rect. Retorna o número de elementos atingidos e pCount os próprios elementos em ppInstanceHandles. Esse método substitui IXamlDiagnostics::HitTest, que pressupõe que há apenas uma janela main e executa apenas o teste de ocorrência dentro dela.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1809 (com SDK do Aplicativo Windows 1.0 ou posterior)
Cabeçalho xamlom.winui.h