Структура GESTURECONFIG (winuser.h)

Статья
08/28/2023

Возвращает и задает конфигурацию для включения сообщений жестов и тип этой конфигурации.

Синтаксис

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

Члены

dwID

Идентификатор типа конфигурации, в которых будут включены или отключены сообщения. Дополнительные сведения см. в подразделе "Примечания".

dwWant

Сообщения для включения.

dwBlock

Отключаемые сообщения.

Нельзя отключить сдвиг двумя пальцами и сохранить сдвиг одним пальцем. Необходимо задать нужные биты для GC_PAN, прежде чем задавать их для GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY или GC_PAN_WITH_SINGLE_FINGER_VERTICALLY.

Вектор инерции включается в сообщение GID_PAN с флагом GF_END, если инерция была отключена вызовом SetGestureConfig.

При передаче этой структуры член dwID содержит сведения для набора жестов. Это определяет, что будут означать другие флаги. Если задать флаги для сообщений сдвига, они будут отличаться от флагов, установленных для сообщений поворота.

В следующей таблице указаны различные идентификаторы жестов, поддерживаемые элементом dwID структуры GESTURECONFIG . Обратите внимание, что параметр dwID в значение 0 означает, что установлены флаги глобальной конфигурации жестов.

Имя	Значение	Описание
GID_ZOOM	3	Указывает параметры конфигурации для жеста масштабирования.
GID_PAN	4	Указывает жест сдвига.
GID_ROTATE	5	Указывает жест поворота.
GID_TWOFINGERTAP	6	Указывает жест касания двумя пальцами.
GID_PRESSANDTAP	7	Указывает жест нажатия и касания.

Следующие флаги используются, если dwID имеет значение 0.

Имя	Значение	Описание
GC_ALLGESTURES	0x00000001	Указывает все жесты.

Следующие флаги используются, если для dwID задано значение GID_ZOOM.

Имя	Значение	Описание
GC_ZOOM	0x00000001	Указывает жест масштабирования.

Следующие флаги используются, если для dwID задано значение GID_PAN.

Имя	Значение	Описание
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	Указывает, что сдвиг с помощью инерции плавно замедляется при остановке жестов сдвига.

Примечание Установка флагов GID_PAN в SetGestureConfig повлияет на обработчик жестов по умолчанию для сдвига. Для одинаковых флагов не следует устанавливать и dwWant , и dwBlock ; это приведет к непредвиденному поведению. Дополнительные сведения о поддержке сдвига и поддержке сдвига прежних версий см. в разделе Жесты Windows Touch. Примеры включения и блокировки жестов см. в разделе SetGestureConfig .

Следующие флаги используются, если для dwID задано значение GID_ROTATE.

Имя	Значение	Описание
GC_ROTATE	0x00000001	Указывает жест поворота.

Если для dwID задано значение GID_TWOFINGERTAP, используются следующие флаги.

Имя	Значение	Описание
GC_TWOFINGERTAP	0x00000001	Указывает жест касания двумя пальцами.

Если для dwID задано значение GID_PRESSANDTAP, используются следующие флаги.

Имя	Значение	Описание
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

Структуры