Estructura GESTURECONFIG (winuser.h)
Obtiene y establece la configuración para habilitar mensajes de gestos y el tipo de esta configuración.
Sintaxis
typedef struct tagGESTURECONFIG {
DWORD dwID;
DWORD dwWant;
DWORD dwBlock;
} GESTURECONFIG, *PGESTURECONFIG;
Miembros
dwID
Identificador del tipo de configuración que tendrá mensajes habilitados o deshabilitados. Para obtener más información, vea la sección Comentarios.
dwWant
Los mensajes que se van a habilitar.
dwBlock
Los mensajes que se van a deshabilitar.
Comentarios
Es imposible deshabilitar el movimiento panorámico de dos dedos y mantener el movimiento panorámico de un solo dedo. Debe establecer los bits deseados para GC_PAN para poder establecerlos para GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY o GC_PAN_WITH_SINGLE_FINGER_VERTICALLY.
Un vector de inercia se incluye en el mensaje GID_PAN con la marca GF_END si la inercia se deshabilitó mediante una llamada a SetGestureConfig.
Al pasar esta estructura, el miembro dwID contiene información para un conjunto de gestos. Esto determina lo que significarán las otras marcas. Si establece marcas para mensajes panorámicos, serán diferentes de las marcas establecidas para los mensajes de rotación.
En la tabla siguiente se indican los distintos identificadores de los gestos admitidos por el miembro dwID de la estructura GESTURECONFIG . Tenga en cuenta que establecer dwID en 0 indica que se establecen las marcas de configuración de gestos globales.
| Nombre | Valor | Descripción |
|---|---|---|
| GID_ZOOM | 3 | Indica los valores de configuración para el gesto de zoom. |
| GID_PAN | 4 | Indica el gesto de movimiento panorámico. |
| GID_ROTATE | 5 | Indica el gesto de rotación. |
| GID_TWOFINGERTAP | 6 | Indica el gesto de pulsar dos dedos. |
| GID_PRESSANDTAP | 7 | Indica el gesto de pulsar y presionar. |
Las marcas siguientes se usan cuando dwID se establece en 0.
| Nombre | Valor | Descripción |
|---|---|---|
| GC_ALLGESTURES | 0x00000001 | Indica todos los gestos. |
Las marcas siguientes se usan cuando dwID se establece en GID_ZOOM.
| Nombre | Valor | Descripción |
|---|---|---|
| GC_ZOOM | 0x00000001 | Indica el gesto de zoom. |
Las marcas siguientes se usan cuando dwID se establece en GID_PAN.
| Nombre | Valor | Descripción |
|---|---|---|
| GC_PAN | 0x00000001 | Indica todos los gestos de movimiento panorámico. |
| GC_PAN_WITH_SINGLE_FINGER_VERTICALLY | 0x00000002 | Indica paneles verticales con un dedo. |
| GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY | 0x00000004 | Indica paneles horizontales con un dedo. |
| GC_PAN_WITH_GUTTER | 0x00000008 | Limita el movimiento perpendicular a la dirección primaria hasta que se alcanza un umbral para salir del canalón. |
| GC_PAN_WITH_INERTIA | 0x00000010 | Indica el movimiento panorámico con inercia para ralentizar suavemente cuando se detengan los gestos de movimiento panorámico. |
| Nombre | Valor | Descripción |
|---|---|---|
| GC_ROTATE | 0x00000001 | Indica el gesto de rotación. |
Las marcas siguientes se usan cuando dwID se establece en GID_TWOFINGERTAP.
| Nombre | Valor | Descripción |
|---|---|---|
| GC_TWOFINGERTAP | 0x00000001 | Indica el gesto de pulsar dos dedos. |
Las marcas siguientes se usan cuando dwID se establece en GID_PRESSANDTAP.
| Nombre | Valor | Descripción |
|---|---|---|
| GC_PRESSANDTAP | 0x00000001 | Indica el gesto de pulsar y presionar. |
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] |
| Encabezado | winuser.h (incluya Windows.h) |