Метод IXamlDiagnostics2::HitTestForXamlRoot (xamlom.winui.h)

Статья
02/23/2024

Возвращает все элементы визуального дерева, которые попадают в указанный прямоугольник.

Синтаксис

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

Параметры

instanceHandle

Дескриптор экземпляра XamlRoot.

rect

Область для проверки нажатия.

pCount

Число найденных элементов.

ppInstanceHandles

Массив, содержащий все найденные элементы.

Возвращаемое значение

Если метод успешно выполнен, возвращает значение S_OK. В противном случае будет возвращен код ошибки HRESULT.

Remarks

Этот метод выполняет проверку попадания для объекта XamlRoot, переданного rectкак instanceHandle, в пределах . Возвращает количество элементов, попав в и pCount самих элементов в ppInstanceHandles. Этот метод заменяет IXamlDiagnostics::HitTest, который предполагает, что есть только одно окно main и выполняет только проверку попадания.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10, версия 1809 (с Windows App SDK 1.0 или более поздней версии)
Верхняя часть	xamlom.winui.h

Поделиться через