Share via

CollectionMode (Enumeración)

  • Artículo

Actualización: noviembre 2007

Define valores que determinan si se reconoce la entrada manuscrita, los movimientos o la entrada manuscrita y los movimientos conforme escribe el usuario.

Espacio de nombres:  Microsoft.Ink
Ensamblado:  Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Enumeration CollectionMode
'Uso
Dim instance As CollectionMode

public enum CollectionMode

public enum class CollectionMode

public enum CollectionMode

public enum CollectionMode

Miembros

Nombre de miembro Descripción
InkOnly Sólo recopila la entrada manuscrita, creando un trazo. El interés del evento InkCollector.Gesture, InkOverlay.Gesture, o InkPicture.Gesture se establece en false, lo que significa que no se recopilan los movimientos (todos los demás intereses del evento permanecen como están).
GestureOnly Sólo recopila movimientos y no crea un trazo. Los movimientos pueden ser de un único trazo o de varios. Los movimientos de varios trazos se aceptan si los trazos se realizan dentro del tiempo establecido por el temporizador integrado del reconocedor. Todos los eventos relacionados con los trazos y los paquetes no se desencadenan mediante el objeto InkCollector, el objeto InkOverlay o el control InkPicture. Se desencadenan los eventos de cursor y siempre se elimina la entrada manuscrita. El interés del evento InkCollector.Gesture, InkOverlay.Gesture, o InkPicture.Gesture se establece en true, lo que significa que se recopilan los movimientos (todos los demás intereses del evento permanecen como están).
InkAndGesture Sólo acepta movimientos de un único trazo. El evento InkCollector.Gesture, InkOverlay.Gesture, o InkPicture.Gesture se desencadena primero, lo que permite cancelar o aceptar el evento. El valor predeterminado es aceptar el evento, excepto si el valor NoGesture de ApplicationGesture, es el movimiento primario. Si se acepta el gesto, se elimina la entrada manuscrita. Si se cancela el movimiento, no se elimina el trazo y se desencadena el evento InkCollector.Stroke, InkOverlay.Strokeo InkPicture.Stroke. El interés del evento InkCollector.Gesture, InkOverlay.Gesture, o InkPicture.Gesture se establece en true, lo que significa que se recopilan los movimientos (todos los demás intereses del evento permanecen como están).

Comentarios

Si un usuario intenta hacer un clic con el botón secundario y mueve la pluma cuando está en modo InkAndGesture o InkOnly, la entrada manuscrita fluye de la punta de la pluma. Al administrar los eventos InkCollector.Stroke, InkPicture.Stroke o InkOverlay.Stroke, borre la entrada manuscrita que fluyó como resultado del movimiento de la pluma.

Si las propiedades InkCollector.CollectionMode, InkOverlay.CollectionMode o InkPicture.CollectionMode se establecen en GestureOnly, el tiempo de espera que transcurre entre el momento en que el usuario agrega un movimiento y el momento en que se producen los eventos InkCollector.Gesture, InkOverlay.Gesture o InkPicture.Gesture es un valor fijo que no puede modificar mediante programación. El reconocimiento de movimientos es más rápido en el modo InkAndGesture. Para evitar la recopilación de entrada manuscrita mientras se está en el modo InkAndGesture, puede:

Al utilizar esta enumeración con el control InkPicture o los objetos InkOverlay o InkCollector, en un sistema que tiene instalado el Kit de desarrollo de software de la edición (SDK) de Microsoft® Windows® XP Tablet PC pero que no tiene instalados reconocedores, el modo no se puede establecer en GestureOnly o InkAndGesture.

Los escenarios típicos de cada modo de colección son los siguientes.

Nota

Si el cursor no se queda fuera del intervalo del objeto de la colección entre los trazos, no se desencadenan eventos de cursor dentro y fuera de intervalo.

Se podría producir un comportamiento no deseado si la propiedad InkCollector.CollectionMode, InkOverlay.CollectionMode o InkPicture.CollectionMode, y el interés de un objeto o control, se establecen en un movimiento conocido (llamando al método InkCollector.SetGestureStatus, InkPicture.SetGestureStatus o InkOverlay.SetGestureStatus). Si un usuario dibuja entrada manuscrita que se parece a un movimiento que está en la lista del reconocedor de alternativas, se desencadena el evento de movimiento y desaparece la entrada manuscrita, aun cuando el movimiento no sea la alternativa principal. Evitar que desaparezca la entrada manuscrita y cancelar la recopilación del movimientos, establezca la propiedad Cancel heredada del objeto InkCollectorGestureEventArgs en true si no desea que el reconocedor responda a ese evento.

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión

.NET Framework

Compatible con: 3.0

Vea también

Referencia

Microsoft.Ink (Espacio de nombres)

InkCollector.CollectionMode

InkOverlay.CollectionMode

InkPicture.CollectionMode