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 ( |