Enumerazione InkCollectionMode (msinkaut.h)

Articolo
03/13/2024

Definisce i valori che determinano se l'input penna, i movimenti o l'input penna e i movimenti vengono riconosciuti come scritture dell'utente.

Sintassi

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

Costanti


`ICM_InkOnly` Valore: 0 Raccoglie solo input penna, creando un tratto. L'interesse per l'evento Gesture è impostato su FALSE, ovvero i movimenti non vengono raccolti (tutti gli altri interessi degli eventi rimangono invariati).
`ICM_GestureOnly` Raccoglie solo i movimenti e non crea un tratto. I movimenti possono essere singoli o multi-tratto. I movimenti a più tratti vengono accettati se i tratti vengono eseguiti entro il tempo impostato dal timer predefinito del riconoscitore. Tutti gli eventi correlati al tratto e relativi ai pacchetti non vengono generati da InkCollector. Gli eventi del cursore vengono attivati e l'input penna viene sempre eliminato. L'interesse dell'evento Gesture è impostato su TRUE, vale a dire che i movimenti vengono raccolti (tutti gli altri interessi degli eventi rimangono invariati).
`ICM_InkAndGesture` Accetta solo movimenti a tratto singolo. L'evento Gesture viene generato per primo, consentendo all'utente di pronunciare Cancel = TRUE o FALSE. Il valore predefinito è TRUE, tranne quando NoGesture è il movimento principale, l'impostazione predefinita Annulla è FALSE. Se TRUE, l'input penna è un movimento e viene eliminato. Se FALSE, il movimento è input penna e viene generato un evento Stroke . L'interesse per l'evento Gesture è impostato su TRUE (tutti gli altri interessi degli eventi vengono mantenuti così come erano).

Commenti

Se un utente tenta di fare clic con il pulsante destro del mouse e sposta la penna in modalità InkOnly o InkAndGesture, l'input penna passa dalla punta della penna. Quando si gestisce l'evento Stroke , è necessario cancellare l'input penna che è stato propagato in seguito al movimento della penna.

Quando InkCollectionMode è impostato su GestureOnly (impostato tramite la proprietà CollectionMode ), il timeout tra quando un utente aggiunge un movimento e quando si verifica l'evento Gesture è un valore fisso che non può essere modificato a livello di codice. Il riconoscimento dei movimenti è più veloce in modalità InkAndGesture. Per evitare la raccolta di input penna in modalità InkAndGesture, è possibile:

Impostare CollectionMode su InkAndGesture.
Nell'evento Stroke eliminare il tratto.
Nell'evento Gesture elaborare il movimento.
Impostare DynamicRendering su FALSE.

Quando si usa questa enumerazione con il controllo InkPicture (o gli oggetti InkCollector o InkOverlay ) in un sistema in cui è installato Microsoft Windows XP Tablet PC Edition Software Development Kit (SDK), ma che non dispone di riconoscitori, la modalità non può essere impostata su GestureOnly o InkAndGesture.

L'agente di raccolta input penna crea sempre un tratto (modalità InkOnly) o un movimento (modalità GestureOnly) e talvolta viene creato entrambi (modalità InkAndGesture).

Di seguito sono riportati gli scenari tipici per ogni modalità.

InkOnly:
1. Viene generato l'evento CursorInRange.
2. Viene generato l'evento NewInAirPackets.
3. Viene generato l'evento CursorDown.
4. Viene generato l'evento NewPackets.
5. Viene creato l'oggetto IInkStrokeDisp.
6. Viene generato l'evento CursorOutOfRange.
Nota È possibile che non si voglia sempre attivare l'evento CursorOutOfRange . Se si desidera continuare a disegnare l'input penna, è possibile tornare agli eventi NewInAirPackets o CursorDown dopo il completamento di un tratto.
GestureOnly:
1. Viene generato l'evento CursorInRange.
2. Viene generato l'evento NewInAirPackets.
3. Viene generato l'evento CursorDown.
4. Viene generato l'evento NewPackets.
5. Viene creato un oggetto IInkGesture oppure, se lo spostamento del cursore non rappresenta un movimento, non accade nulla.
6. Viene generato l'evento CursorOutOfRange.
Nota In questa modalità vengono accettati movimenti a tratti singoli o multipli.
InkAndGesture:
1. Viene generato l'evento CursorInRange.
2. Viene generato l'evento NewInAirPackets.
3. Viene generato l'evento CursorDown.
4. Viene generato l'evento NewPackets.
5. Viene creato un oggetto IInkGesture o un oggetto IInkStrokeDisp .
6. Viene generato l'evento CursorOutOfRange.
Nota In questa modalità vengono accettati solo i movimenti a tratto singolo.

Il comportamento indesiderato può verificarsi quando la proprietà CollectionMode è impostata su InkAndGesture e l'interesse di un oggetto o di un controllo in un movimento noto viene impostato (chiamando il metodo SetGestureStatus ). Se un utente disegna input penna simile a un gesto che si trova nell'elenco di alternative di riconoscimento del riconoscimento, l'evento Gesture viene generato e l'input penna scompare, anche se il gesto non è l'alternativa superiore. Per impedire la scomparsa dell'input penna e l'annullamento della raccolta del movimento, impostare Annulla su TRUE se l'evento è uno a cui non si vuole che il riconoscitore risponda.