CloseGestureInfoHandle 函数 (winuser.h)

关闭与手势信息句柄关联的资源。

语法

BOOL CloseGestureInfoHandle(
  HGESTUREINFO hGestureInfo
);

参数

hGestureInfo

手势信息句柄。

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。 若要获取扩展错误信息，请使用 GetLastError 函数。

注解

如果应用程序处理 WM_GESTURE 消息，则它负责使用此函数关闭句柄。 否则可能会导致进程内存泄漏。

如果消息传递到 DefWindowProc，或使用 API 函数的 PostMessage 或 SendMessage 类之一转发，则句柄随消息一起传输，并且不需要由应用程序关闭。

示例

下面的代码显示了一个处理程序，该处理程序在已处理手势时关闭 GESTUREINFO 句柄。

  LRESULT DecodeGesture(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam){
    // Create a structure to populate and retrieve the extra message info.
    GESTUREINFO gi;  
    
    ZeroMemory(&gi, sizeof(GESTUREINFO));
    
    gi.cbSize = sizeof(GESTUREINFO);

    BOOL bResult  = GetGestureInfo((HGESTUREINFO)lParam, &gi);
    BOOL bHandled = FALSE;

    if (bResult){
        // now interpret the gesture
        switch (gi.dwID){
           case GID_ZOOM:
               // Code for zooming goes here     
               bHandled = TRUE;
               break;
           case GID_PAN:
               // Code for panning goes here
               bHandled = TRUE;
               break;
           case GID_ROTATE:
               // Code for rotation goes here
               bHandled = TRUE;
               break;
           case GID_TWOFINGERTAP:
               // Code for two-finger tap goes here
               bHandled = TRUE;
               break;
           case GID_PRESSANDTAP:
               // Code for roll over goes here
               bHandled = TRUE;
               break;
           default:
               // A gesture was not recognized
               break;
        }
    }else{
        DWORD dwErr = GetLastError();
        if (dwErr > 0){
            //MessageBoxW(hWnd, L"Error!", L"Could not retrieve a GESTUREINFO structure.", MB_OK);
        }
    }
    if (bHandled){
        return 0;
    }else{
        return DefWindowProc(hWnd, message, wParam, lParam);
    }
  }

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	在 Windows 8.1) 中引入的 ext-ms-win-ntuser-misc-l1-2-0 (

请参阅

函数

手势编程指南