Evento InkEdit.Gesture
Se produce cuando se reconoce un gesto de aplicación.
Sintaxis
HRESULT Gesture(
[in] IInkCursor *Cursor,
[in] IInkStrokes *Strokes,
[in] VARIANT Gestures,
[in, out] VARIANT_BOOL *Cancel
);
Parámetros
-
Cursor [in]
-
Objeto IInkCursor que se usó para crear este gesto.
-
Trazos [in]
-
La colección InkStrokes que contiene los objetos IInkStrokeDisp que componen este gesto.
-
Gestos [in]
-
Matriz de objetos IInkGesture , en orden de confianza.
Para obtener más información sobre la estructura VARIANT, vea Uso de la biblioteca COM.
-
Cancelar [in, out]
-
Si se debe cancelar la colección InkStrokes que constituye este gesto, por lo que no se borrará la entrada de lápiz y se activará el evento Stroke .
Valor devuelto
Si este evento se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .
Observaciones
Este método de evento se define en la interfaz _IInkEditEvents . La interfaz _IInkEditEvents implementa la interfaz IDispatch con un identificador de DISPID_IeeGesture.
Un evento Gesture solo se genera si el IInkStrokeDisp para el objeto IInkGesture es el primer objeto IInkStrokeDisp desde la última llamada al método Recognize o la última activación del tiempo de espera de reconocimiento.
Si se cancela el evento Gesture , se genera el evento Stroke para la colección InkStrokes que generó el evento Gesture .
Para que se produzca este evento, el control InkEdit debe suscribirse a un conjunto de gestos de aplicación. Para establecer el interés del control InkEdit en un conjunto de gestos, llame al método SetGestureStatus .
Para obtener una lista de gestos de aplicación, consulte el tipo de enumeración InkApplicationGesture .
El control InkEdit no reconoce varios gestos de trazo.
El control InkEdit se suscribe a los siguientes gestos.
| Gesto | Acción |
|---|---|
| Abajo a la izquierda, hacia abajo a la izquierda |
Entrar |
| Right |
Space |
| Izquierda |
Retroceso |
| Arriba a la derecha, a la derecha y a la derecha |
Pestaña |
Para modificar la acción predeterminada de un gesto:
- Agregue controladores de eventos para los eventos Gesto y Trazo .
- En el controlador de eventos Gesture , cancele el evento Gesture para el gesto y realice la acción alternativa para el gesto.
- En el controlador de eventos Stroke , cancele el evento Stroke del objeto IInkStrokeDisp que generó el evento Gesture cancelado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows XP Tablet PC Edition [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
No se admite ninguno |
| Encabezado |
|
| Biblioteca |
|