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
UI 요소의 경계 상자를 정의하는 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 |
| 헤더 | winuser.h |
| 라이브러리 | User32.lib |
| DLL | User32.dll |