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

참조

함수