GetGestureConfig 函数-中文整理

利用CGestureConfig类操作的代码示例如下：

CGestureConfig config;
GetGestureConfig(&config);

检索要针对其从窗口中发送 Windows Touch 笔势消息的配置。

语法

BOOL WINAPI GetGestureConfig(
  __in     HWND hwnd,
  __in     DWORD dwReserved,
  __in     DWORD dwFlags,
  __in     PUINT pcIDs,
  __inout  PGESTURECONFIG pGestureConfig,
  __in     UINT cbSize
);

参数

hwnd [in]要从中获取笔势配置的窗口的句柄。dwReserved [in]此值已被保留且必须设置为 0。dwFlags [in]指示用于检索笔势配置的选项的笔势命令标志值。有关其他信息和支持的值，请参见“备注”。pcIDs [in]位于 pGestureConfig 缓冲区中的大小（按笔势配置结构的数目计算）。pGestureConfig [in, out]指定笔势配置的笔势配置结构的数组。cbSize [in]笔势配置 (GESTURECONFIG) 结构的大小。

返回值

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

评论

传递一个不是

sizeof(GESTURECONFIG)

的值用于 cbSize 参数将导致调用此函数失败，并且 GetLastError 将返回 ERROR_INVALID_PARAMETER（十进制的 87）。下表列出了笔势配置值：

名称	值	说明
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();                                       
    }