Función GetGestureConfig (winuser.h)
Recupera la configuración para la que se envían mensajes de gestos de Windows Touch desde una ventana.
Sintaxis
BOOL GetGestureConfig(
[in] HWND hwnd,
[in] DWORD dwReserved,
[in] DWORD dwFlags,
[in] PUINT pcIDs,
[in, out] PGESTURECONFIG pGestureConfig,
[in] UINT cbSize
);
Parámetros
[in] hwnd
Identificador de la ventana para obtener la configuración de gestos.
[in] dwReserved
Este valor está reservado y debe establecerse en 0.
[in] dwFlags
Valor de marca de comando de gesto que indica las opciones para recuperar la configuración de gestos. Vea Comentarios para obtener información adicional y valores admitidos.
[in] pcIDs
Tamaño, en número de estructuras de configuración de gestos, que se encuentra en el búfer pGestureConfig .
[in, out] pGestureConfig
Matriz de estructuras de configuración de gestos que especifican la configuración de gestos.
[in] cbSize
Tamaño de la estructura de configuración de gestos (GESTURECONFIG).
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, use la función GetLastError .
Comentarios
Si se pasa un valor distinto sizeof(GESTURECONFIG) del parámetro cbSize , se producirá un error en las llamadas a esta función y GetLastError devolverá ERROR_INVALID_PARAMETER (87 en decimal).
En la tabla siguiente se enumeran los valores de configuración de gestos:
| Nombre | Valor | Descripción |
|---|---|---|
| GCF_INCLUDE_ANCESTORS | 0x00000001 | Si se especifica, GetGestureConfig devuelve la configuración consolidada de la ventana especificada y su cadena de ventanas primaria. |
Ejemplos
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();
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winuser.h (incluir Windows.h) |
| Library | User32.lib |
| Archivo DLL | User32.dll |
| Conjunto de API | ext-ms-win-ntuser-misc-l1-2-0 (introducido en Windows 8.1) |