Compartir a través de

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

  • Artículo

Obtiene todos los elementos del árbol visual que se encuentran dentro del rectángulo especificado.

Sintaxis

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

Parámetros

instanceHandle

Identificador de la instancia de XamlRoot.

rect

Área a la que se va a realizar la prueba de posicionamiento.

pCount

Número de elementos encontrados.

ppInstanceHandles

Matriz que contiene todos los elementos encontrados.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Observaciones

Este método realiza pruebas de posicionamiento para xamlRoot pasado como instanceHandle, dentro de los límites de rect. Devuelve el número de elementos alcanzados en pCount y los propios elementos de ppInstanceHandles. Este método reemplaza A IXamlDiagnostics::HitTest, que supone que solo hay una ventana principal y que solo realiza pruebas de posicionamiento dentro de él.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1809 (con SDK de Aplicaciones para Windows 1.0 o posterior)
Encabezado xamlom.winui.h