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:

1. Agregue controladores de eventos para los eventos Gesto y Trazo .
2. En el controlador de eventos Gesture , cancele el evento Gesture para el gesto y realice la acción alternativa para el gesto.
3. 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	Inked.h (también requiere inked_i.c)
Biblioteca	InkEd.dll

Vea también

InkEdit

InkApplicationGesture (enumeración)

Método SetGestureStatus [Control InkEdit]

RecoTimeout (propiedad)

Evento Stroke [Control InkEdit]

Uso de gestos