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();                                       
    }