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

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 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 ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT.

Observaciones

Este método realiza pruebas de posicionamiento para xamlRoot pasados 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 IXamlDiagnostics::HitTest, que supone que solo hay una ventana principal y solo realiza pruebas de posicionamiento dentro de él.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10, versión 1809 (con Windows App SDK 1.0 o posterior)
encabezado	xamlom.winui.h