WM_GESTURE 메시지

제스처에 대한 정보를 전달합니다.

매개 변수

wParam

제스처 명령 및 제스처 관련 인수 값을 식별하는 정보를 제공합니다. 이 정보는 GESTUREINFO 구조체의 ullArguments 멤버에 전달된 것과 동일한 정보입니다.

lParam

제스처 명령 및 제스처 관련 인수 값을 식별하는 정보에 대한 핸들을 제공합니다. 이 정보는 GetGestureInfo를 호출하여 검색됩니다.

반환 값

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

애플리케이션이 메시지를 처리하지 않는 경우 DefWindowProc를 호출해야 합니다. 이렇게 하지 않으면 터치 입력 핸들이 닫혀 있지 않고 연결된 프로세스 메모리가 해제되지 않으므로 애플리케이션에서 메모리가 누수됩니다.

설명

다음 표에서는 지원되는 제스처 명령을 나열합니다.

제스처 ID 값(dwID) Description
GID_BEGIN 1 제네릭 제스처가 시작되었음을 나타냅니다.
GID_END 2 제네릭 제스처 끝을 나타냅니다.
GID_ZOOM 3 확대/축소 시작, 확대/축소 이동 또는 확대/축소 중지를 나타냅니다. 첫 번째 GID_ZOOM 명령 메시지는 확대/축소를 시작하지만 확대/축소는 발생하지 않습니다. 두 번째 GID_ZOOM 명령은 첫 번째 GID_ZOOM 포함된 상태를 기준으로 확대/축소를 트리거합니다.
GID_PAN 4 이동 또는 이동 시작을 나타냅니다. 첫 번째 GID_PAN 명령은 이동 시작을 나타내지만 이동은 수행하지 않습니다. 두 번째 GID_PAN 명령 메시지를 사용하면 애플리케이션이 이동이 시작됩니다.
GID_ROTATE 5 회전 이동 또는 회전 시작을 나타냅니다. 첫 번째 GID_ROTATE 명령 메시지는 회전 이동 또는 회전 시작을 나타내지만 회전하지 않습니다. 두 번째 GID_ROTATE 명령 메시지는 첫 번째 GID_ROTATE 포함된 상태를 기준으로 회전 작업을 트리거합니다.
GID_TWOFINGERTAP 6 두 손가락 탭 제스처를 나타냅니다.
GID_PRESSANDTAP 7 누르기 및 탭 제스처를 나타냅니다.

참고

레거시 지원을 사용하려면 GID_BEGINGID_END 제스처 명령이 있는 메시지를 DefWindowProc을 사용하여 전달해야 합니다.

다음 표에서는 lParamwParam 매개 변수에 전달된 제스처 인수를 나타냅니다.

제스처 ID 제스처 ullArgument GestureInfo 구조의 ptsLocation
GID_ZOOM 확대/축소 두 점 사이의 거리를 나타냅니다. 확대/축소의 중심을 나타냅니다.
GID_PAN 이동 두 점 사이의 거리를 나타냅니다. 팬의 현재 위치를 나타냅니다.
GID_ROTATE 회전(피벗) GF_BEGIN 플래그가 설정된 경우 회전 각도를 나타냅니다. 그렇지 않으면 회전이 시작된 이후의 각도 변경입니다. 회전 방향을 나타내기 위해 서명됩니다. GID_ROTATE_ANGLE_FROM_ARGUMENTGID_ROTATE_ANGLE_TO_ARGUMENT 매크로를 사용하여 각도 값을 가져와서 설정합니다. 이는 대상 개체가 회전되는 고정 지점인 회전의 중심을 나타냅니다.
GID_TWOFINGERTAP 두 손가락으로 탭 두 손가락 사이의 거리를 나타냅니다. 두 손가락의 중심을 나타냅니다.
GID_PRESSANDTAP 누른 후 탭 첫 번째 손가락과 두 번째 손가락 사이의 델타를 나타냅니다. 이 값은 POINT 구조에서 ullArgument의 하위 32비트 안에 저장됩니다. 첫 번째 손가락이 내려 오는 위치를 나타냅니다.

참고

모든 거리와 위치는 실제 화면 좌표로 제공됩니다.

참고

dwIDullArgument 매개 변수는 GID_* 명령과 함께 제공되는 것으로 간주되어야 하며 애플리케이션에서 변경해서는 안 됩니다.

예제

다음 코드에서는 이 메시지와 관련된 제스처 관련 정보를 가져오는 방법을 보여 줍니다.

참고

처리되지 않은 메시지를 항상 DefWindowProc 에 전달해야 하며 CloseGestureInfoHandle 호출을 사용하여 처리할 메시지에 대한 제스처 입력 핸들을 닫아야 합니다. 이 예제에서는 TOUCHINPUT 핸들이 각 제스처 사례에서 닫혀 있기 때문에 기본 제스처 처리기 동작이 표시되지 않습니다. 처리되지 않은 메시지에 대한 위의 코드에서 사례를 제거한 경우 기본 제스처 처리기는 기본 사례에서 DefWindowProc 으로 전달하여 메시지를 처리합니다.

  LRESULT DecodeGesture(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam){
    // Create a structure to populate and retrieve the extra message info.
    GESTUREINFO gi;  
    
    ZeroMemory(&gi, sizeof(GESTUREINFO));
    
    gi.cbSize = sizeof(GESTUREINFO);

    BOOL bResult  = GetGestureInfo((HGESTUREINFO)lParam, &gi);
    BOOL bHandled = FALSE;

    if (bResult){
        // now interpret the gesture
        switch (gi.dwID){
           case GID_ZOOM:
               // Code for zooming goes here     
               bHandled = TRUE;
               break;
           case GID_PAN:
               // Code for panning goes here
               bHandled = TRUE;
               break;
           case GID_ROTATE:
               // Code for rotation goes here
               bHandled = TRUE;
               break;
           case GID_TWOFINGERTAP:
               // Code for two-finger tap goes here
               bHandled = TRUE;
               break;
           case GID_PRESSANDTAP:
               // Code for roll over goes here
               bHandled = TRUE;
               break;
           default:
               // A gesture was not recognized
               break;
        }
    }else{
        DWORD dwErr = GetLastError();
        if (dwErr > 0){
            //MessageBoxW(hWnd, L"Error!", L"Could not retrieve a GESTUREINFO structure.", MB_OK);
        }
    }
    if (bHandled){
        return 0;
    }else{
        return DefWindowProc(hWnd, message, wParam, lParam);
    }
  }

요구 사항

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

추가 정보

알림

Windows 터치 제스처 프로그래밍 가이드