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

  • Статья

Извлекает структуру 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)

См. также

Функции

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