iXamlDiagnostics::HitTest 方法 (xamlom.h)

获取位于指定矩形内的可视化树中的所有元素。

语法

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

参数

[in] rect

要命中测试的区域。

[out] pCount

数组大小。

[out] ppInstanceHandles

包含所有元素的数组。

返回值

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此方法在 XAML 可视化树上执行命中测试,并将返回所有元素,无论它们是启用还是不可见进行命中测试。 此方法不返回折叠的元素,因为它们不参与布局。 在此方法之前,必须调用 AdviseVisualTreeChange。 元素不需要完全封闭在要返回的 矩形 区域中。

要求

要求
最低受支持的客户端 Windows 10 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
目标平台 Windows
标头 xamlom.h

另请参阅

IXamlDiagnostics