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

Obtient tous les éléments de l’arborescence visuelle qui se trouvent dans le rectangle spécifié.

Syntaxe

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

Paramètres

instanceHandle

Handle de l’instance XamlRoot.

rect

Zone à tester.

pCount

Nombre d’éléments trouvés.

ppInstanceHandles

Tableau contenant tous les éléments trouvés.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Cette méthode effectue des tests d’accès pour le xamlRoot passé en tant que instanceHandle, dans les limites de rect. Retourne le nombre d’éléments atteints dans pCount et les éléments eux-mêmes dans ppInstanceHandles. Cette méthode remplace IXamlDiagnostics ::HitTest, qui suppose qu’il n’y a qu’une seule fenêtre main et qu’elle n’effectue que des tests de positionnement.

Configuration requise