WM_MOUSEWHEEL 메시지
마우스 휠이 회전될 때 포커스 창에 전송됩니다. DefWindowProc 함수는 메시지를 창의 부모에 전파합니다. DefWindowProc은 메시지를 처리하는 창을 찾을 때까지 부모 체인에 전파하므로 메시지의 내부 전달이 없어야 합니다.
창은 WindowProc 함수를 통해 이 메시지를 받습니다.
#define WM_MOUSEWHEEL 0x020A
매개 변수
-
wParam
-
상위 단어는 휠이 회전되는 거리인 120을 나타내며 WHEEL_DELTA의 곱하기 또는 나누기로 표현됩니다. 양수 값은 휠이 사용자로부터 멀리 앞으로 회전되었음을 나타내고, 음수 값은 휠이 사용자를 향해 뒤로 회전되었음을 나타냅니다.
하위 단어는 다양한 가상 키가 눌려져 있는지 여부를 나타냅니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.
값 의미 - MK_CONTROL
- 0x0008
Ctrl 키가 눌려져 있습니다. - MK_LBUTTON
- 0x0001
마우스 왼쪽 단추가 눌려져 있습니다. - MK_MBUTTON
- 0x0010
마우스 가운데 단추가 눌려져 있습니다. - MK_RBUTTON
- 0x0002
마우스 오른쪽 단추가 눌려져 있습니다. - MK_SHIFT
- 0x0004
Shift 키가 눌려져 있습니다. - MK_XBUTTON1
- 0x0020
첫 번째 X 단추가 눌려져 있습니다. - MK_XBUTTON2
- 0x0040
두 번째 X 단추가 눌러져 있습니다. -
lParam
-
하위 단어는 화면의 왼쪽 위 모서리를 기준으로 포인터의 x 좌표를 지정합니다.
상위 단어는 화면의 왼쪽 위 모서리를 기준으로 포인터의 y 좌표를 지정합니다.
반환 값
애플리케이션이 이 메시지를 처리하면 0을 반환해야 합니다.
설명
다음 코드를 사용하여 wParam 매개 변수에서 정보를 가져옵니다.
fwKeys = GET_KEYSTATE_WPARAM(wParam);
zDelta = GET_WHEEL_DELTA_WPARAM(wParam);
다음 코드를 사용하여 가로 및 세로 위치를 가져옵니다.
xPos = GET_X_LPARAM(lParam);
yPos = GET_Y_LPARAM(lParam);
위에서 설명한 대로 x 좌표는 반환 값의 하위 short에 있고 y 좌표는 반환 값의 상위 short에 있습니다. 둘 다 여러 모니터가 있는 시스템에서 음수 값을 사용할 수 있으므로 부호 있는 값을 나타냅니다. 반환 값이 변수에 할당된 경우 MAKEPOINTS 매크로를 사용하여 반환 값에서 POINTS 구조체를 가져올 수 있습니다. GET_X_LPARAM 또는 GET_Y_LPARAM 매크로를 사용하여 x 또는 y 좌표를 추출할 수도 있습니다.
중요
LOWORD 또는 HIWORD 매크로는 여러 모니터가 있는 시스템에서 잘못된 결과를 반환하므로 이 매크로를 사용하여 커서 위치의 x 및 y 좌표를 추출하지 마세요. 여러 모니터가 있는 시스템에서는 x 및 y 좌표가 음수일 수 있으며 LOWORD 및 HIWORD는 좌표를 부호 없는 수량으로 처리합니다.
휠 회전은 120으로 설정된 WHEEL_DELTA의 배수가 됩니다. 이는 수행할 작업에 대한 임계값이며 각 델타에 대해 이러한 작업(예: 한 증분 스크롤) 하나가 수행되어야 합니다.
델타는 Microsoft 또는 다른 공급업체가 더 정밀한 해상도의 휠(톱니 없이 자유롭게 회전하는 휠)을 제작해 회전당 더 많은 메시지를 보낼 수 있도록 하기 위해 120으로 설정되었지만, 각 메시지의 값은 더 작습니다. 이 기능을 사용하려면 WHEEL_DELTA에 도달할 때까지 들어오는 델타 값을 추가하여 델타 회전에 대해 동일한 응답을 얻거나 더 빈번한 메시지에 대한 응답으로 부분 줄을 스크롤할 수 있습니다. 스크롤 세분성을 선택하고 도달할 때까지 델타를 누적할 수도 있습니다.
MSH_MOUSEWHEEL에 대한 fwKeys는 없습니다. 있으면 매개 변수가 WM_MOUSEWHEEL와 정확히 동일합니다.
애플리케이션은 모든 포함 개체 또는 컨트롤에 MSH_MOUSEWHEEL을 전달해야 합니다. 애플리케이션은 활성 상태의 포함된 OLE 애플리케이션에 메시지를 보내야 합니다. 선택적으로 애플리케이션은 포커스가 있는 휠 지원 컨트롤에 메시지를 보낼 수 있습니다. 애플리케이션이 컨트롤에 메시지를 보내는 경우 반환 값을 검사하여 메시지가 처리되었는지 확인할 수 있습니다. 컨트롤이 메시지를 처리하는 경우 TRUE 값을 반환해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 |
Windows 2000 Server[데스크톱 앱만] |
| 헤더 |
|