다음을 통해 공유

WM_XBUTTONDOWN 메시지

  • 아티클

커서가 창의 클라이언트 영역에 있는 동안 사용자가 XBUTTON1 또는 XBUTTON2 누를 때 게시됩니다. 마우스를 캡처하지 않으면 메시지가 커서 아래 창에 게시됩니다. 그렇지 않으면 메시지가 마우스를 캡처한 창에 게시됩니다.

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

#define WM_XBUTTONDOWN                  0x020B

매개 변수

wParam

낮은 순서의 단어는 다양한 가상 키가 다운되었는지 여부를 나타냅니다. 다음 값 중 하나 이상이 될 수 있습니다.

값 의미
MK_CONTROL
0x0008
 Ctrl 키가 다운되었습니다.
MK_LBUTTON
0x0001
 마우스 왼쪽 단추가 아래쪽에 있습니다.
MK_MBUTTON
0x0010
 마우스 가운데 단추가 아래쪽에 있습니다.
MK_RBUTTON
0x0002
 마우스 오른쪽 단추가 아래쪽에 있습니다.
MK_SHIFT
0x0004
 SHIFT 키가 다운되었습니다.
MK_XBUTTON1
0x0020
 XBUTTON1 다운되었습니다.
MK_XBUTTON2
0x0040
 XBUTTON2 다운되었습니다.

상위 단어는 클릭한 단추를 나타냅니다. 다음 값 중 하나일 수 있습니다.

값 의미
XBUTTON1
0x0001
 XBUTTON1 클릭했습니다.
XBUTTON2
0x0002
 XBUTTON2 클릭했습니다.

lParam

낮은 순서의 단어는 커서의 x 좌표를 지정합니다. 좌표는 클라이언트 영역의 왼쪽 위 모서리를 기준으로 합니다.

상위 단어는 커서의 y 좌표를 지정합니다. 좌표는 클라이언트 영역의 왼쪽 위 모서리를 기준으로 합니다.

반환 값

애플리케이션이 이 메시지를 처리하는 경우 TRUE반환해야 합니다. 반환 값 처리에 대한 자세한 내용은 설명 섹션을 참조하세요.

발언

Windows는 최대 5개의 단추(왼쪽, 가운데 및 오른쪽)와 XBUTTON1 및 XBUTTON2 두 개의 추가 단추가 있는 마우스를 지원합니다. XBUTTON1 및 XBUTTON2 단추는 종종 마우스 측면, 베이스 근처에 있습니다. 이러한 추가 버튼은 모든 마우스에 존재하지 않습니다. 있는 경우 XBUTTON1 및 XBUTTON2 단추는 웹 브라우저에서 앞으로 및 뒤로 탐색과 같은 애플리케이션 함수에 매핑되는 경우가 많습니다.

다음 코드를 사용하여 wParam 매개 변수의 정보를 가져옵니다.

fwKeys = GET_KEYSTATE_WPARAM (wParam); 
fwButton = GET_XBUTTON_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를 좌표를 서명되지 않은 수량으로 처리할 있습니다.

WM_LBUTTONDOWN, WM_MBUTTONDOWN및 WM_RBUTTONDOWN 메시지와 달리 애플리케이션은 처리할 경우 이 메시지에서 TRUE 반환해야 합니다. 이렇게 하면 Windows 2000 이전의 Windows 시스템에서 이 메시지를 시뮬레이트하는 소프트웨어가 창 프로시저에서 메시지를 처리했는지 아니면 DefWindowProc 호출하여 처리할지를 결정할 수 있습니다.

요구 사항

요구 값
지원되는 최소 클라이언트
 Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows 2000 Server [데스크톱 앱만 해당]
머리글
Winuser.h(Windowsx.h 포함)

참고 항목

참조

GET_KEYSTATE_WPARAM

GET_X_LPARAM

GET_XBUTTON_WPARAM

GET_Y_LPARAM

GetCapture

setCapture

WM_XBUTTONDBLCLK

WM_XBUTTONUP

개념

마우스 입력

기타 리소스

MAKEPOINTS

POINTS