Структура GESTURECONFIG (winuser.h)
Возвращает и задает конфигурацию для включения сообщений жестов и тип этой конфигурации.
Синтаксис
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 | Указывает, что сдвиг с помощью инерции плавно замедляется при остановке жестов сдвига. |
| Имя | Значение | Описание |
|---|---|---|
| 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) |