GetGestureInfo 函数

在给定笔势信息的句柄的情况下检索笔势信息结构。

语法

BOOL WINAPI GetGestureInfo(
  __in   HGESTUREINFO hGestureInfo,
  __out  PGESTUREINFO pGestureInfo
);

参数

hGestureInfo [in]

笔势信息句柄。

pGestureInfo [out]

一个指向笔势信息结构的指针。

返回值

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

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

评论

在调用该函数之前,必须设置传入该函数的 GESTUREINFO 结构的 cbSize 成员。否则,调用 GetLastError 将返回 ERROR_INVALID_PARAMETER(十进制的 87)。如果某个应用程序处理 WM_GESTURE 消息,则该应用程序负责关闭使用 CloseGestureInfoHandle 的句柄。如果不这样做,则可能会导致进程内存泄漏。

如果将该消息传递给 DefWindowProc,或者使用 API 函数的一个 PostMessage 或 SendMessage 类转发该消息,则将通过该消息传送句柄,并且应用程序无需关闭句柄。

示例


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

    if (!bResult){                
        DWORD err = GetLastError();                                       
    }
    

要求

最低支持的客户端

Windows 7

最低支持的服务器

Windows Server 2008 R2

标头

Winuser.h (包括Windows.h)

User32.lib

DLL

User32.dll

另请参见

函数
笔势编程指南

 

 

社区附加资源

添加
显示:
© 2014 Microsoft