iXamlDiagnostics2::HitTestForXamlRoot 方法 (xamlom.winui.h)

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

语法

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

参数

instanceHandle

XamlRoot 实例的句柄。

rect

要命中测试的区域。

pCount

找到的元素数。

ppInstanceHandles

包含所有找到的元素的数组。

返回值

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

备注

此方法在 的边界内对作为 instanceHandle传入的 rectXamlRoot 执行命中测试。 返回 中命中的 pCount 元素数以及 中的 ppInstanceHandles元素本身。 此方法替换 IXamlDiagnostics::HitTest,后者假定只有一个main窗口,并且只在其中执行命中测试。

要求

要求
最低受支持的客户端 使用 Windows 应用 SDK 1.0 或更高版本的 Windows 10 版本 1809 ()
标头 xamlom.winui.h