Freigeben über


IXamlDiagnostics::HitTest-Methode (xamlom.h)

Ruft alle Elemente in der visuellen Struktur ab, die innerhalb des angegebenen Rechtecks liegen.

Syntax

HRESULT HitTest(
  [in]  RECT           rect,
  [out] unsigned int   *pCount,
  [out] InstanceHandle **ppInstanceHandles
);

Parameter

[in] rect

Der Bereich, der getestet werden soll.

[out] pCount

Die Größe des Arrays.

[out] ppInstanceHandles

Ein Array, das alle Elemente enthält.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode führt einen Treffertest für die visuelle XAML-Struktur durch und gibt alle Elemente zurück, unabhängig davon, ob sie für Treffertests aktiviert oder nicht sichtbar sind. Diese Methode gibt keine reduzierten Elemente zurück, da sie nicht am Layout teilnehmen. AdviseVisualTreeChange muss vor dieser Methode aufgerufen werden. Das Element muss nicht vollständig in den zurückzugebenden Rechteckbereich eingeschlossen werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile xamlom.h

Weitere Informationen

IXamlDiagnostics