Функция GetGestureConfig (winuser.h)

Статья
03/15/2023

Извлекает конфигурацию, для которой сообщения жестов Windows Touch отправляются из окна.

Синтаксис

BOOL GetGestureConfig(
  [in]      HWND           hwnd,
  [in]      DWORD          dwReserved,
  [in]      DWORD          dwFlags,
  [in]      PUINT          pcIDs,
  [in, out] PGESTURECONFIG pGestureConfig,
  [in]      UINT           cbSize
);

Параметры

[in] hwnd

Дескриптор окна для получения конфигурации жеста.

[in] dwReserved

Это значение зарезервировано и должно иметь значение 0.

[in] dwFlags

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

[in] pcIDs

Размер в количестве структур конфигурации жестов, который находится в буфере pGestureConfig .

[in, out] pGestureConfig

Массив структур конфигурации жестов, определяющих конфигурацию жестов.

[in] cbSize

Размер структуры конфигурации жестов (GESTURECONFIG).

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить расширенные сведения об ошибке, используйте функцию GetLastError .

Имя	Значение	Описание
GCF_INCLUDE_ANCESTORS	0x00000001	Если этот параметр задан, GetGestureConfig возвращает консолидированную конфигурацию для указанного окна и его родительской цепочки окон.

Примеры

    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 [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-misc-l1-2-0 (представлено в Windows 8.1)

См. также

Функции

GESTURECONFIG

Руководство по программированию жестов

Поделиться через