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

Artículo
03/08/2023

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

Ninguno

Observaciones

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

Nota El objeto InkCollector , el objeto InkOverlay o el control InkPicture genera 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; no son gestos.
El interés del evento Gesture se establece en FALSE (todos los demás intereses de evento permanecen tal cual).

Modo GestureOnly

Solo se recopilan gestos; la entrada de lápiz 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 cual).
El recopilador de tintas no activa los siguientes eventos relacionados con trazo y paquetes: los eventos CursorDown, Stroke, NewPackets y NewInAirPackets .
Se activan los eventos de cursor.
Siempre se elimina la entrada de lápiz.

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 cual).
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. Cancelar el gesto obliga al recopilador de tinta a recopilar la entrada de lápiz.

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 el interés de un objeto/control en un gesto conocido se establece (llamando al método SetGestureStatus ). Si dibuja tinta similar al gesto conocido y el gesto conocido está 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 entrada de lápiz mientras se encuentra en el modo InkAndGesture , puede hacer lo siguiente:

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

Requisitos


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