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


Метод 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
Header xamlom.h

См. также раздел

IXamlDiagnostics