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 | 이동 제스처가 중지될 때 관성으로 이동이 원활히 느려짐을 나타냅니다. |
| 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 포함) |