메시지
이 섹션의 topics 특정 포인터 입력 메시지 및 알림에 대한 참조 사양을 제공합니다.
섹션 내용
| 항목 | 설명 |
|---|---|
|
DM_POINTERHITTEST |
직접 조작에 가장 가능성이 있는 입력 대상을 결정하기 위해 포인터 입력이 처음 검색될 때 창으로 전송됩니다. |
|
WM_NCPOINTERDOWN |
포인터가 창의 비 클라이언트 영역에 연결할 때 게시됩니다. 메시지는 포인터가 접촉하는 창을 대상으로 합니다. 포인터는 창에 암시적으로 캡처되므로 창이 연락처를 끊을 때까지 포인터에 대한 입력을 계속 받습니다. 창에서 이 포인터를 캡처한 경우 이 메시지가 게시되지 않습니다. 대신 이 포인터를 캡처한 창에 WM_POINTERDOWN 게시됩니다. 중요: 데스크톱 앱은 DPI를 인식해야 합니다. 앱이 DPI를 인식하지 못하는 경우 DPI 가상화로 인해 포인터 메시지 및 관련 구조에 포함된 화면 좌표가 부정확해 보일 수 있습니다. DPI 가상화는 DPI를 인식하지 못하고 기본적으로 활성 상태인 애플리케이션에 대한 자동 크기 조정 지원을 제공합니다(사용자가 해제할 수 있음). 자세한 내용은 High-DPI Win32 애플리케이션 작성을 참조하세요. |
|
WM_NCPOINTERUP |
창의 비 클라이언트 영역에 대한 연락처를 만든 포인터가 연락처를 끊을 때 게시됩니다. 메시지는 포인터가 연락처를 만들고 포인터가 창에 암시적으로 캡처되는 창을 대상으로 하므로 창이 WM_NCPOINTERUP 알림을 포함하여 연락처를 끊을 때까지 포인터에 대한 입력을 계속 받을 수 있습니다. 창에서 이 포인터를 캡처한 경우 이 메시지가 게시되지 않습니다. 대신 이 포인터를 캡처한 창에 WM_POINTERUP 게시됩니다. 중요: 데스크톱 앱은 DPI를 인식해야 합니다. 앱이 DPI를 인식하지 못하는 경우 DPI 가상화로 인해 포인터 메시지 및 관련 구조에 포함된 화면 좌표가 부정확해 보일 수 있습니다. DPI 가상화는 DPI를 인식하지 못하고 기본적으로 활성 상태인 애플리케이션에 대한 자동 크기 조정 지원을 제공합니다(사용자가 해제할 수 있음). 자세한 내용은 High-DPI Win32 애플리케이션 작성을 참조하세요. |
|
WM_NCPOINTERUPDATE |
창의 비 클라이언트 영역에 연락처를 만든 포인터에 대한 업데이트를 제공하거나 마우스로 가리키지 않은 대화 상대가 창의 비 클라이언트 영역 위로 이동할 때 업데이트를 제공하기 위해 게시됩니다. 포인터가 가리키고 있는 동안 메시지는 포인터가 끝난 창을 대상으로 합니다. 포인터가 표면과 접촉하는 동안 포인터는 포인터가 접촉한 창에 암시적으로 캡처되고 해당 창은 접촉이 중단될 때까지 포인터에 대한 입력을 계속 받습니다. 창에서 이 포인터를 캡처한 경우 이 메시지가 게시되지 않습니다. 대신 이 포인터를 캡처한 창에 WM_POINTERUPDATE 게시됩니다. 중요: 데스크톱 앱은 DPI를 인식해야 합니다. 앱이 DPI를 인식하지 못하는 경우 DPI 가상화로 인해 포인터 메시지 및 관련 구조에 포함된 화면 좌표가 부정확해 보일 수 있습니다. DPI 가상화는 DPI를 인식하지 못하고 기본적으로 활성 상태인 애플리케이션에 대한 자동 크기 조정 지원을 제공합니다(사용자가 해제할 수 있음). 자세한 내용은 High-DPI Win32 애플리케이션 작성을 참조하세요. |
|
WM_PARENTNOTIFY |
하위 창에서 중요한 작업이 발생할 때 창으로 전송됩니다. 이 메시지는 이제 WM_POINTERDOWN 이벤트를 포함하도록 확장되었습니다. 자식 창을 만들 때 시스템은 창을 만드는 CreateWindow 또는 CreateWindowEx 함수가 반환되기 직전에 WM_PARENTNOTIFY 보냅니다. 자식 창이 제거되면 시스템에서 창을 삭제하는 처리를 하기 전에 메시지를 보냅니다. 창은 WindowProc 함수를 통해 이 메시지를 받습니다. 중요: 데스크톱 앱은 DPI를 인식해야 합니다. 앱이 DPI를 인식하지 못하는 경우 DPI 가상화로 인해 포인터 메시지 및 관련 구조에 포함된 화면 좌표가 부정확해 보일 수 있습니다. DPI 가상화는 DPI를 인식하지 못하고 기본적으로 활성 상태인 애플리케이션에 대한 자동 크기 조정 지원을 제공합니다(사용자가 해제할 수 있음). 자세한 내용은 High-DPI Win32 애플리케이션 작성을 참조하세요. |
|
WM_POINTERACTIVATE |
기본 포인터가 창 위에 WM_POINTERDOWN 생성할 때 비활성 창으로 전송됩니다. 메시지가 처리되지 않은 상태로 유지되면 최상위 창에 도달할 때까지 부모 창 체인 위로 이동합니다. 애플리케이션은 이 메시지에 응답하여 활성화할지 여부를 지정할 수 있습니다. 창은 WindowProc 함수를 통해 이 메시지를 받습니다. |
|
WM_POINTERCAPTURECHANGED |
입력 포인터 캡처가 손실되는 창으로 전송됩니다. 창은 WindowProc 함수를 통해 이 메시지를 받습니다. |
|
WM_POINTERDEVICECHANGE |
디지타이저가 연결된 모니터의 설정이 변경되면 창으로 전송됩니다. 이 메시지에는 디스플레이 모드의 크기 조정에 대한 정보가 포함되어 있습니다. |
|
WM_POINTERDEVICEINRANGE |
입력 디지타이저 범위 내에서 포인터 디바이스가 검색되면 창으로 전송됩니다. 이 메시지에는 디바이스 및 해당 근접에 대한 정보가 포함되어 있습니다. |
|
WM_POINTERDEVICEOUTOFRANGE |
포인터 디바이스가 입력 디지타이저 범위를 벗어나면 창으로 전송됩니다. 이 메시지에는 디바이스 및 해당 근접에 대한 정보가 포함되어 있습니다. |
|
WM_POINTERDOWN |
포인터가 창의 클라이언트 영역에 연결할 때 게시됩니다. 이 입력 메시지는 포인터가 연락처를 만드는 창을 대상으로 하며 포인터가 창에 암시적으로 캡처되므로 창이 연락처를 끊을 때까지 포인터에 대한 입력을 계속 받을 수 있습니다. 창은 WindowProc 함수를 통해 이 메시지를 받습니다. 중요: 데스크톱 앱은 DPI를 인식해야 합니다. 앱이 DPI를 인식하지 못하는 경우 DPI 가상화로 인해 포인터 메시지 및 관련 구조에 포함된 화면 좌표가 부정확해 보일 수 있습니다. DPI 가상화는 DPI를 인식하지 못하고 기본적으로 활성 상태인 애플리케이션에 대한 자동 크기 조정 지원을 제공합니다(사용자가 해제할 수 있음). 자세한 내용은 High-DPI Win32 애플리케이션 작성을 참조하세요. |
|
WM_POINTERENTER |
새 포인터가 창(가리키기)을 통해 검색 범위에 들어가거나 기존 포인터가 창의 경계 내에서 이동할 때 창으로 전송됩니다. |
|
WM_POINTERLEAVE |
포인터가 검색 범위를 창 위로 나가거나 포인터가 창의 경계를 벗어나는 경우 창으로 전송됩니다. |
|
WM_POINTERROUTEDAWAY |
포인터 입력이 다른 프로세스로 라우팅되면 입력을 받는 프로세스에서 발생합니다. |
|
WM_POINTERROUTEDRELEASED |
현재 프로세스에서 WM_POINTERUP 메시지가 수신될 때 특정 포인터 ID와 연결된 모든 프로세스(AddContentWithCrossProcessChaining을 통해 교차 프로세스 체인을 구성하고 현재 포인터 입력을 처리하지 않음)로 전송됩니다. |
|
WM_POINTERROUTEDTO |
기존 포인터 ID에 대해 진행 중인 포인터 입력 시 전송된 프로세스 간 연결(AddContentWithCrossProcessChaining)을 위해 구성된 콘텐츠에서 한 프로세스에서 다른 프로세스로 전환됩니다. |
|
WM_POINTERUP |
창의 클라이언트 영역에서 연락처를 연결한 포인터가 연락처를 끊을 때 게시됩니다. 이 입력 메시지는 포인터가 연락처를 만들고 포인터가 창에 암시적으로 캡처되는 창을 대상으로 하므로 창이 연락처를 끊을 때까지 포인터에 대한 WM_POINTERUP 알림을 포함한 입력 메시지를 계속 받을 수 있습니다. 창은 WindowProc 함수를 통해 이 메시지를 받습니다. 중요: 데스크톱 앱은 DPI를 인식해야 합니다. 앱이 DPI를 인식하지 못하는 경우 DPI 가상화로 인해 포인터 메시지 및 관련 구조에 포함된 화면 좌표가 부정확해 보일 수 있습니다. DPI 가상화는 DPI를 인식하지 못하고 기본적으로 활성 상태인 애플리케이션에 대한 자동 크기 조정 지원을 제공합니다(사용자가 해제할 수 있음). 자세한 내용은 High-DPI Win32 애플리케이션 작성을 참조하세요. |
|
WM_POINTERUPDATE |
창의 클라이언트 영역 또는 창의 클라이언트 영역 위에 마우스로 가리키지 않은 포인터에 대한 연락처를 만든 포인터에 대한 업데이트를 제공하기 위해 게시됩니다. 포인터가 가리키고 있는 동안 메시지는 포인터가 끝난 창을 대상으로 합니다. 포인터가 표면과 접촉하는 동안 포인터는 포인터가 접촉한 창에 암시적으로 캡처되고 해당 창은 접촉이 끊어질 때까지 포인터에 대한 입력을 계속 받습니다. 중요: 데스크톱 앱은 DPI를 인식해야 합니다. 앱이 DPI를 인식하지 못하는 경우 DPI 가상화로 인해 포인터 메시지 및 관련 구조에 포함된 화면 좌표가 부정확하게 나타날 수 있습니다. DPI 가상화는 DPI를 인식하지 못하고 기본적으로 활성 상태인 애플리케이션에 대한 자동 크기 조정 지원을 제공합니다(사용자가 해제할 수 있음). 자세한 내용은 High-DPI Win32 애플리케이션 작성을 참조하세요. |
|
WM_POINTERWHEEL |
스크롤 휠을 회전할 때 전경 키보드 포커스가 있는 창에 게시됩니다. 창은 WindowProc 함수를 통해 이 메시지를 받습니다. 중요: 데스크톱 앱은 DPI를 인식해야 합니다. 앱이 DPI를 인식하지 못하는 경우 DPI 가상화로 인해 포인터 메시지 및 관련 구조에 포함된 화면 좌표가 부정확하게 나타날 수 있습니다. DPI 가상화는 DPI를 인식하지 못하고 기본적으로 활성 상태인 애플리케이션에 대한 자동 크기 조정 지원을 제공합니다(사용자가 해제할 수 있음). 자세한 내용은 High-DPI Win32 애플리케이션 작성을 참조하세요. |
|
WM_POINTERHWHEEL |
가로 스크롤 휠을 회전할 때 전경 키보드 포커스가 있는 창에 게시됩니다. 창은 WindowProc 함수를 통해 이 메시지를 받습니다. 중요: 데스크톱 앱은 DPI를 인식해야 합니다. 앱이 DPI를 인식하지 못하는 경우 DPI 가상화로 인해 포인터 메시지 및 관련 구조에 포함된 화면 좌표가 부정확하게 나타날 수 있습니다. DPI 가상화는 DPI를 인식하지 못하고 기본적으로 활성 상태인 애플리케이션에 대한 자동 크기 조정 지원을 제공합니다(사용자가 해제할 수 있음). 자세한 내용은 High-DPI Win32 애플리케이션 작성을 참조하세요. |
|
WM_TOUCHHITTESTING |
가장 가능성이 큰 터치 대상을 결정하기 위해 터치 다운의 창으로 전송됩니다. |