Enumeración InkCollectionMode (msinkaut.h)

Define valores que determinan si la entrada de lápiz, los gestos o la entrada de lápiz y los gestos se reconocen como escribe el usuario.

Syntax

typedef enum InkCollectionMode {
  ICM_InkOnly = 0,
  ICM_GestureOnly,
  ICM_InkAndGesture
} ;

Constantes

ICM_InkOnly Valor: 0 Recopila solo entrada de lápiz, creando un trazo. El interés del evento Gesture se establece en FALSE, lo que significa que los gestos no se recopilan (todos los demás intereses de evento permanecen como estaban).
ICM_GestureOnly Recopila solo gestos y no crea un trazo. Los gestos pueden ser de un solo trazo o de varios trazos. Se aceptan gestos de varios trazos si los trazos se realizan dentro del tiempo establecido por el temporizador integrado del reconocedor. Todos los eventos relacionados con los trazos y relacionados con paquetes no se activan desde inkCollector. Los eventos de cursor se activan y siempre se elimina la entrada de lápiz. El interés del evento Gesture se establece en TRUE, lo que significa que los gestos se recopilan (todos los demás intereses de evento permanecen tal cual).
ICM_InkAndGesture Acepta solo gestos de un solo trazo. El evento Gesture se activa primero, lo que proporciona al usuario la capacidad de decir Cancelar = TRUE o FALSE. El valor predeterminado es TRUE, excepto cuando NoGesture es el gesto principal, Cancel tiene como valor predeterminado FALSE. Si es TRUE, la entrada de lápiz es un gesto y se elimina. Si es FALSE, el gesto es ink y se desencadena un evento Stroke . El interés del evento Gesture se establece en TRUE (todos los demás intereses de evento se mantienen tal cual).

Comentarios

Si un usuario intenta hacer clic con el botón derecho y mueve el lápiz cuando está en modo InkOnly o InkAndGesture, la entrada de lápiz fluye desde la punta del lápiz. Al controlar el evento Stroke , debe borrar la entrada de lápiz que fluyó como resultado del movimiento del lápiz.

Cuando InkCollectionMode se establece en GestureOnly (establecido a través de la propiedad CollectionMode ), el tiempo de espera entre cuando un usuario agrega un gesto y cuando se produce el evento Gesture es un valor fijo que no se puede modificar mediante programación. El reconocimiento de gestos es más rápido en el modo InkAndGesture. Para evitar la colección de entrada de lápiz mientras se encuentra en el modo InkAndGesture, puede hacer lo siguiente:

• Establezca CollectionMode en InkAndGesture.
• En el evento Stroke , elimine el trazo.
• En el evento Gesture , procese el gesto.
• Establezca DynamicRendering en FALSE.

Cuando se usa esta enumeración con el control InkPicture (o los objetos InkCollector o InkOverlay ) en un sistema que tiene instalado el Kit de desarrollo de software (SDK) para tabletas de Microsoft Windows XP Tablet, pero que no tiene reconocedores, el modo no se puede establecer en GestureOnly o InkAndGesture.

El recopilador de lápiz siempre crea un trazo (modo InkOnly) o un gesto (modo GestureOnly) y a veces se crean ambos (modo InkAndGesture).

Los escenarios típicos para cada modo siguen.

• InkOnly:
  1. Se desencadena el evento CursorInRange.
  2. Se desencadena el evento NewInAirPackets.
  3. Se desencadena el evento CursorDown.
  4. Se desencadena el evento NewPackets.
  5. Se crea el objeto IInkStrokeDisp.
  6. Se desencadena el evento CursorOutOfRange.
  Nota Es posible que no siempre quiera activar el evento CursorOutOfRange . Si desea continuar dibujando tinta, puede volver a los eventos NewInAirPackets o CursorDown después de completar un trazo.
   
• GestureOnly:
  1. Se desencadena el evento CursorInRange.
  2. Se desencadena el evento NewInAirPackets.
  3. Se desencadena el evento CursorDown.
  4. Se desencadena el evento NewPackets.
  5. Se crea un objeto IInkGesture o, si el movimiento del cursor no representa un gesto, no sucede nada.
  6. Se desencadena el evento CursorOutOfRange.
  Nota Los gestos de un solo o varios trazos se aceptan en este modo.
   
• InkAndGesture:
  1. Se desencadena el evento CursorInRange.
  2. Se desencadena el evento NewInAirPackets.
  3. Se desencadena el evento CursorDown.
  4. Se desencadena el evento NewPackets.
  5. Se crea un objeto IInkGesture o un objeto IInkStrokeDisp .
  6. Se desencadena el evento CursorOutOfRange.
  Nota Solo se aceptan gestos de un solo trazo en este modo.
   

El comportamiento no deseado puede producirse cuando la propiedad CollectionMode se establece en InkAndGesture y el interés de un objeto o control en un gesto conocido se establece (llamando al método SetGestureStatus ). Si un usuario dibuja tinta similar a un gesto que se encuentra en la lista de reconocimientos alternativos del reconocedor, el evento Gesture se activa y desaparece la entrada de lápiz, incluso si el gesto no es la alternativa superior. Para evitar que la entrada de lápiz desaparezca y cancele la colección del gesto, establezca Cancelar en TRUE si el evento es uno al que no desea que responda el reconocedor.

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	msinkaut.h

Consulte también

Propiedad CollectionMode [Clase InkCollector]

Evento de gesto

InkCollector (clase)

InkOverlay (clase)

Referencia del control InkPicture

Evento stroke