GESTURECONFIG 구조체(winuser.h)

제스처 메시지 및 이 구성의 형식을 사용하도록 설정하기 위한 구성을 가져오고 설정합니다.

구문

typedef struct tagGESTURECONFIG {
  DWORD dwID;
  DWORD dwWant;
  DWORD dwBlock;
} GESTURECONFIG, *PGESTURECONFIG;

멤버

dwID

메시지를 사용하거나 사용하지 않도록 설정할 구성 유형에 대한 식별자입니다. 자세한 내용은 설명 부분을 참조하세요.

dwWant

사용할 메시지입니다.

dwBlock

사용하지 않도록 설정할 메시지입니다.

설명

두 손가락 이동 기능을 사용하지 않도록 설정하고 한 손가락으로 이동하면 안 됩니다. GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY 또는 GC_PAN_WITH_SINGLE_FINGER_VERTICALLY 설정하려면 먼저 GC_PAN 원하는 비트를 설정해야 합니다.

관성은 SetGestureConfig 호출에 의해 비활성화된 경우 GF_END 플래그와 함께 GID_PAN 메시지에 포함됩니다.

이 구조를 전달하면 dwID 멤버에 제스처 집합에 대한 정보가 포함됩니다. 이는 다른 플래그의 의미를 결정합니다. 팬 메시지에 대한 플래그를 설정하는 경우 순환 메시지에 대해 설정된 플래그와 다릅니다.

다음 표에서는 GESTURECONFIG 구조체의 dwID 멤버에서 지원하는 제스처에 대한 다양한 식별자를 나타냅니다. dwID를 0으로 설정한다는 것은 전역 제스처 구성 플래그가 설정되었음을 나타냅니다.

Name	값	Description
GID_ZOOM	3	확대/축소 제스처에 대한 구성 설정을 나타냅니다.
GID_PAN	4	팬 제스처를 나타냅니다.
GID_ROTATE	5	회전 제스처를 나타냅니다.
GID_TWOFINGERTAP	6	두 손가락 탭 제스처를 나타냅니다.
GID_PRESSANDTAP	7	누르기 및 탭 제스처를 나타냅니다.

 

dwID가 0으로 설정된 경우 다음 플래그가 사용됩니다.

Name	값	Description
GC_ALLGESTURES	0x00000001	모든 제스처를 나타냅니다.

 

dwID가 GID_ZOOM 설정된 경우 다음 플래그가 사용됩니다.

Name	값	Description
GC_ZOOM	0x00000001	확대/축소 제스처를 나타냅니다.

 

dwID가 GID_PAN 설정된 경우 다음 플래그가 사용됩니다.

Name	값	Description
GC_PAN	0x00000001	모든 팬 제스처를 나타냅니다.
GC_PAN_WITH_SINGLE_FINGER_VERTICALLY	0x00000002	한 손가락으로 세로 창을 나타냅니다.
GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY	0x00000004	한 손가락으로 가로 팬을 나타냅니다.
GC_PAN_WITH_GUTTER	0x00000008	임계값에 도달하여 배수로에서 분리될 때까지 수직 이동을 기본 방향으로 제한합니다.
GC_PAN_WITH_INERTIA	0x00000010	이동 제스처가 중지될 때 관성으로 이동이 원활히 느려짐을 나타냅니다.

 

참고SetGestureConfig에서 GID_PAN 플래그를 설정하면 이동에 대한 기본 제스처 처리기에 영향을 줍니다. 동일한 플래그에 대해 dwWant 및 dwBlock 을 둘 다 설정해서는 안 됩니다. 이로 인해 예기치 않은 동작이 발생합니다. 이동 및 레거시 이동 지원에 대한 자세한 내용은 Windows 터치 제스처 를 참조하세요. 제스처를 사용하도록 설정하고 차단하는 예제 는 SetGestureConfig 를 참조하세요.

 

dwID가 GID_ROTATE 설정된 경우 다음 플래그가 사용됩니다.

Name	값	Description
GC_ROTATE	0x00000001	회전 제스처를 나타냅니다.

 

dwID가 GID_TWOFINGERTAP 설정된 경우 다음 플래그가 사용됩니다.

Name	값	Description
GC_TWOFINGERTAP	0x00000001	두 손가락 탭 제스처를 나타냅니다.

 

dwID가 GID_PRESSANDTAP 설정된 경우 다음 플래그가 사용됩니다.

Name	값	Description
GC_PRESSANDTAP	0x00000001	누르기 및 탭 제스처를 나타냅니다.

 

예제

    GESTURECONFIG gc[3];    
    UINT uiGcs = 3;

    ZeroMemory(&gc, sizeof(gc));
    gc[0].dwID  = GID_ZOOM;
    gc[1].dwID  = GID_ROTATE;
    gc[2].dwID  = GID_PAN;
    BOOL bResult = GetGestureConfig(hWnd, 0, 0, &uiGcs, gc, sizeof(GESTURECONFIG));        
    if (!bResult){                
        DWORD err = GetLastError();                                       
    }    

요구 사항

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

추가 정보

GetGestureConfig

SetGestureConfig

구조체