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


Функция EvaluateProximityToRect (winuser.h)

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

Синтаксис

BOOL EvaluateProximityToRect(
  [in]  const RECT                             *controlBoundingBox,
  [in]  const TOUCH_HIT_TESTING_INPUT          *pHitTestingInput,
  [out] TOUCH_HIT_TESTING_PROXIMITY_EVALUATION *pProximityEval
);

Параметры

[in] controlBoundingBox

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

[in] pHitTestingInput

Структура TOUCH_HIT_TESTING_INPUT , в которой хранятся данные для сенсорной области контакта.

[out] pProximityEval

Структура TOUCH_HIT_TESTING_PROXIMITY_EVALUATION , содержащая оценку и скорректированные данные о точках касания.

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

Если эта функция выполняется успешно, она возвращает значение TRUE.

В противном случае возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите функцию GetLastError .

Комментарии

Для обеспечения согласованности с Windows платформы, обрабатывающие WM_TOUCHHITTESTING , должны использовать следующие принципы.

  • Включение. Если точка касания находится в пределах элемента управления, точка касания не изменяется.
  • Пересечение. Включает только элементы управления, которые пересекаются с геометрией контакта.
  • Z-порядок. Если геометрия контакта пересекается с несколькими элементами управления, а элементы управления перекрываются, приоритет получает элемент управления, который находится в Z-порядке.
  • Неоднозначность. Если геометрия контакта пересекается с несколькими элементами управления, а элементы управления не перекрываются, элемент управления, ближайший к исходной точке касания, получает приоритет.

Требования

   
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header winuser.h
Библиотека User32.lib
DLL User32.dll

См. также

Функции