WM_NCPOINTERUPDATE 메시지

창의 비 클라이언트 영역에 대해 연락처를 만든 포인터 또는 가리키지 않은 연결이 창의 비 클라이언트 영역 위로 이동할 때의 업데이트를 제공하기 위해 게시됩니다. 포인터가 가리키고 있는 동안 메시지는 포인터가 끝난 창을 대상으로 합니다. 포인터가 표면과 접촉하는 동안 포인터는 포인터가 접촉한 창에 암시적으로 캡처되고 해당 창은 접촉이 끊어지도록 포인터에 대한 입력을 계속 받습니다.

창에서 이 포인터를 캡처한 경우 이 메시지는 게시되지 않습니다. 대신 이 포인터를 캡처한 창에 WM_POINTERUPDATE 게시됩니다.

! [중요]
데스크톱 앱은 DPI를 인식해야 합니다. 앱이 DPI를 인식하지 못하는 경우 DPI 가상화로 인해 포인터 메시지 및 관련 구조에 포함된 화면 좌표가 부정확해 보일 수 있습니다. DPI 가상화는 DPI를 인식하지 않고 기본적으로 활성 상태인 애플리케이션에 대한 자동 크기 조정 지원을 제공합니다(사용자가 해제할 수 있음). 자세한 내용은 High-DPI Win32 애플리케이션 작성을 참조 하세요.

#define WM_NCPOINTERUPDATE                 0x0241

매개 변수

wParam

포인터 식별자 및 추가 정보를 포함합니다. 다음 매크로를 사용하여 이 정보를 검색합니다.

GET_POINTERID_WPARAM(wParam): 포인터 식별자

HIWORD(wParam): WM_NCHITTEST 메시지 처리에서 반환된 적중 테스트 값입니다.

lParam

포인터의 점 위치를 포함합니다.

참고 항목

포인터가 사소한 영역을 통해 디바이스와 접촉할 수 있으므로 이 지점 위치는 더 복잡한 포인터 영역의 단순화일 수 있습니다. 가능하면 애플리케이션은 지점 위치 대신 전체 포인터 영역 정보를 사용해야 합니다.

다음 매크로를 사용하여 점의 실제 화면 좌표를 검색합니다.

• GET_X_LPARAM(lParam): x(가로 점) 좌표입니다.
• GET_Y_LPARAM(lParam): y(세로 점) 좌표입니다.

반환 값

애플리케이션이 이 메시지를 처리하면 0을 반환해야 합니다.

애플리케이션이 이 메시지를 처리하지 않는 경우 DefWindowProc를 호출해야 합니다.

설명

애플리케이션이 이 메시지를 처리하지 않는 경우 DefWindowProc는 메시지에 포함된 적중 테스트 결과에 따라 하나 이상의 시스템 작업을 수행할 수 있습니다. 일반적으로 애플리케이션은 이 메시지를 처리할 필요가 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
헤더	Winuser.h(Windows.h 포함)

참고 항목

메시지