通过

getGestureConfig 函数 (winuser.h)

  • 项目

检索从窗口为其发送 Windows Touch 手势消息的配置。

语法

BOOL GetGestureConfig(
  [in]      HWND           hwnd,
  [in]      DWORD          dwReserved,
  [in]      DWORD          dwFlags,
  [in]      PUINT          pcIDs,
  [in, out] PGESTURECONFIG pGestureConfig,
  [in]      UINT           cbSize
);

参数

[in] hwnd

要从中获取手势配置的窗口的句柄。

[in] dwReserved

此值是保留的，必须设置为 0。

[in] dwFlags

一个手势命令标志值，该值指示用于检索手势配置的选项。 有关其他信息和支持的值，请参阅备注。

[in] pcIDs

pGestureConfig 缓冲区中手势配置结构数的大小。

[in, out] pGestureConfig

指定手势配置的手势配置结构的数组。

[in] cbSize

手势配置的大小 (GESTURECONFIG) 结构。

返回值

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

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

注解

传递 cbSize 参数以外的sizeof(GESTURECONFIG)值将导致对此函数的调用失败，GetLastError 将返回十进制) ( 87 ERROR_INVALID_PARAMETER。

下表列出了手势配置值：

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

要求

要求 值
最低受支持的客户端 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 (

请参阅

函数

GESTURECONFIG

手势编程指南