Функция EvaluateProximityToPolygon (winuser.h)
Возвращает оценку многоугольника в качестве вероятной цели касания (по сравнению со всеми другими многоугольниками, пересекающими контактную область касания), и скорректированную точку касания в многоугольнике.
Синтаксис
BOOL EvaluateProximityToPolygon(
UINT32 numVertices,
[in] const POINT *controlPolygon,
[in] const TOUCH_HIT_TESTING_INPUT *pHitTestingInput,
[out] TOUCH_HIT_TESTING_PROXIMITY_EVALUATION *pProximityEval
);
Параметры
numVertices
Число вершин в многоугольнике. Это значение должно быть больше или равно 3.
Это значение указывает размер массива, заданный параметром controlPolygon .
[in] controlPolygon
Массив координат экрана x-y, определяющий форму элемента пользовательского интерфейса.
Параметр numVertices указывает количество координат.
[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 |