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

Статья
08/27/2023

Извлекает структуру GESTUREINFO , заданную дескриптором для сведений жеста.

Синтаксис

BOOL GetGestureInfo(
  [in]  HGESTUREINFO hGestureInfo,
  [out] PGESTUREINFO pGestureInfo
);

Параметры

[in] hGestureInfo

Дескриптор сведений о жесте.

[out] pGestureInfo

Указатель на структуру сведений о жесте.

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

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

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

Перед вызовом функции необходимо задать элемент cbSize структуры GESTUREINFO , передаваемый в функцию. В противном случае вызовы GetLastError будут возвращать ERROR_INVALID_PARAMETER (87 в десятичном формате). Если приложение обрабатывает сообщение WM_GESTURE , оно отвечает за закрытие дескриптора с помощью CloseGestureInfoHandle. Невыполнение этого действия может привести к утечке памяти процесса.

Если сообщение передается в DefWindowProc или пересылается с помощью одного из классов PostMessage или SendMessage функций API, дескриптор передается вместе с сообщением и не должен закрываться приложением.

Примеры


    GESTUREINFO gestureInfo = {0};
    gestureInfo.cbSize = sizeof(gestureInfo);
    BOOL bResult = GetGestureInfo((HGESTUREINFO)lParam, &gestureInfo);

    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)

См. также

Функции

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

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