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
UI 요소의 모양을 정의하는 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 |
| 헤더 | winuser.h |
| 라이브러리 | User32.lib |
| DLL | User32.dll |