Método IInkCollector::get_CollectionMode (msinkaut.h)

  • Artículo

Obtiene o establece el modo de colección que determina si la entrada de lápiz, el gesto o ambos se reconocen como escribe el usuario.

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT get_CollectionMode(
  InkCollectionMode *Mode
);

Parámetros

Mode

Valor devuelto

None

Observaciones

Para obtener una lista de los modos que puede usar, vea el tipo de enumeración InkCollectionMode . Sin embargo, cuando se usa la propiedad CollectionMode en un sistema que tiene instalado el Kit de desarrollo de software (SDK) de Microsoft Windows XP Tablet PC Edition, pero que no tiene instalado reconocedor, el modo no se puede establecer en GestureOnly o InkAndGesture.

Nota El objeto InkCollector , el objeto InkOverlay o el control InkPicture generan un error si intenta cambiar la propiedad CollectionMode mientras se recopila la entrada de lápiz. Para evitar este conflicto, compruebe la propiedad CollectingInk antes de cambiar la propiedad CollectionMode .
 
Los comportamientos siguientes se producen para cada uno de los valores CollectionMode :

Modo InkOnly

  • Sólo se recopila la entrada de lápiz; Los gestos no son.
  • El interés del evento Gesture se establece en FALSE (todos los demás intereses de evento permanecen tal como estaban).

Modo GestureOnly

  • Solo se recopilan gestos; ink no es. Los trazos se eliminan después de enviarlos al reconocedor de gestos.
  • El interés del evento Gesture se establece en TRUE (todos los demás intereses de evento permanecen tal como estaban).
  • El recopilador de tintas no desencadena los siguientes eventos relacionados con el trazo y los paquetes: los eventos CursorDown, Stroke, NewPackets y NewInAirPackets .
  • Se activan los eventos de cursor.
  • La entrada de lápiz siempre se elimina.

Modo InkAndGesture

  • Se recopilan tanto la entrada de lápiz como los gestos.
  • Solo se reconocen los gestos de un solo trazo.
  • El interés del evento Gesture se establece en TRUE (todos los demás intereses de evento permanecen tal como estaban).
  • El evento Gesture se activa primero, lo que le permite aceptar o cancelar el gesto. Para cancelar el gesto, establezca el parámetro Cancel en TRUE. Al cancelar el gesto, el recopilador de tintas obliga a recopilar la tinta.
Cambiar el modo de colección no modifica el estado de los gestos individuales.

El comportamiento no deseado puede producirse cuando CollectionMode se establece en InkAndGesture y se establece el interés de un objeto/control en un gesto conocido (llamando al método SetGestureStatus ). Si dibuja lápiz que tiene un aspecto similar al gesto conocido y el gesto conocido se encuentra en la lista de alternativas 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 el parámetro Cancel en TRUE si el evento es el que no tiene interés.

Cuando CollectionMode se establece en GestureOnly, 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 tinta mientras se encuentra en el modo InkAndGesture , puede:

  1. Establezca la propiedad CollectionMode en InkAndGesture.
  2. En el evento Stroke , elimine el trazo.
  3. En el evento Gesture , procese el gesto.
  4. Establezca DynamicRendering en FALSE para evitar el flujo de entrada de lápiz mientras se gesturing.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado msinkaut.h
Library InkObj.dll

Consulte también

CollectingInk (propiedad)

Propiedad Enabled

IInkCollector

InkCollectionMode (enumeración)

Clase InkCollector