WM_MOUSEHWHEEL 메시지

  • 아티클

마우스의 가로 스크롤 휠을 기울이거나 돌릴 때 활성 창으로 보내집니다. DefWindowProc 함수는 메시지를 창의 부모에 전파합니다. DefWindowProc은 메시지를 처리하는 창을 찾을 때까지 부모 체인에 전파하므로 메시지의 내부 전달이 없어야 합니다.

창은 WindowProc 함수를 통해 이 메시지를 받습니다.

#define WM_MOUSEHWHEEL                  0x020E

매개 변수

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 좌표는 반환 값보다 낮은 순서로 짧습니다. y 좌표는 높은 순서로 짧습니다(둘 다 여러 모니터가 있는 시스템에서 음수 값을 사용할 수 있으므로 부호가 있는 값을 나타냄). 반환 값이 변수에 할당된 경우 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에 도달할 때까지 들어오는 델타 값을 추가하거나(따라서 델타 회전에 대해 동일한 응답을 얻음) 더 빈번한 메시지에 대한 응답으로 부분 줄을 스크롤할 수 있습니다. 또한 스크롤 세분성을 선택하고 도달할 때까지 델타를 누적할 수도 있습니다.

요구 사항

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

추가 정보

참조

GET_KEYSTATE_WPARAM

GET_X_LPARAM

GET_Y_LPARAM

GET_WHEEL_DELTA_WPARAM

HIWORD

LOWORD

mouse_event

개념

마우스 입력

기타 리소스

GetSystemMetrics

MAKEPOINTS

POINTS

SystemParametersInfo