Condividi tramite

Enumerazione CollectionMode

  • Articolo

Aggiornamento: novembre 2007

Definisce i valori che determinano se mentre l'utente scrive vengono riconosciuti i movimenti, l'input penna o entrambi.

Spazio dei nomi:  Microsoft.Ink
Assembly:  Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Enumeration CollectionMode
'Utilizzo
Dim instance As CollectionMode

public enum CollectionMode

public enum class CollectionMode

public enum CollectionMode

public enum CollectionMode

Membri

Nome membro Descrizione
InkOnly Raccoglie solo input penna, creando un tratto. L'interesse dell'evento InkCollector.Gesture, InkOverlay.Gesture o InkPicture.Gesture viene impostato su false, a indicare che i movimenti non vengono raccolti (tutti gli altri interessi dell'evento rimangono inalterati).
GestureOnly Raccoglie solo movimenti e non crea un tratto. I movimenti possono essere a un solo tratto o a più tratti. I movimenti a più tratti sono accettati se i tratti vengono effettuati entro il periodo di tempo impostato dal timer incorporato del riconoscimento. Tutti gli eventi correlati al tratto e al pacchetto non vengono generati dall'oggetto InkCollector, dall'oggetto InkOverlay o dal controllo InkPicture. Vengono generati eventi di cursore e l'input penna viene sempre eliminato. L'interesse dell'evento InkCollector.Gesture, InkOverlay.Gesture o InkPicture.Gesture viene impostato su true, a indicare che i movimenti vengono raccolti (tutti gli altri interessi dell'evento rimangono inalterati).
InkAndGesture Accetta solo movimenti a un solo tratto. Viene prima generato l'evento InkCollector.Gesture, InkOverlay.Gesture o InkPicture.Gesture, che consente di annullare o accettare l'evento. L'impostazione predefinita è l'accettazione dell'evento, tranne nel caso in cui il valore NoGesture di ApplicationGesture sia il movimento primario. Se il movimento viene accettato, l'input penna viene eliminato. Se il movimento viene annullato, il tratto non viene eliminato e viene generato un evento InkCollector.Stroke, InkOverlay.Stroke o InkPicture.Stroke. L'interesse dell'evento InkCollector.Gesture, InkOverlay.Gesture o InkPicture.Gesture viene impostato su true, a indicare che i movimenti vengono raccolti (tutti gli altri interessi dell'evento rimangono inalterati).

Note

Se un utente tenta di fare clic con il pulsante destro del mouse e sposta la penna mentre è attivata la modalità InkOnly o InkAndGesture, dalla punta della penna viene generato l'input penna. Quando si gestisce l'evento InkCollector.Stroke, InkOverlay.Stroke o InkPicture.Stroke, cancellare l'input penna prodotto dal movimento della penna.

Quando la proprietà InkCollector.CollectionMode, InkOverlay.CollectionMode o InkPicture.CollectionMode è impostata su GestureOnly, il timeout tra l'aggiunta di un movimento da parte dell'utente e la generazione dell'evento InkCollector.Gesture, InkOverlay.Gesture o InkPicture.Gesture è un valore fisso che non può essere modificato a livello di codice. Il riconoscimento del movimento è più veloce in modalità InkAndGesture. Per impedire la raccolta dell'input penna in modalità InkAndGesture, è possibile:

Quando si utilizza 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 riconoscimenti, non è possibile impostare la modalità su GestureOnly o InkAndGesture.

Di seguito vengono presentati alcuni scenari tipici per ogni modalità di raccolta.

Nota

Se il cursore non viene spostato all'esterno dell'intervallo dell'oggetto insieme tra i tratti, gli eventi di cursore nell'intervallo e di cursore esterno all'intervallo non vengono generati.

È possibile che si verifichino comportamenti imprevisti quando si impostano la proprietà InkCollector.CollectionMode, InkOverlay.CollectionMode o InkPicture.CollectionMode e l'interesse di un oggetto o controllo in un movimento noto, mediante la chiamata al metodo InkCollector.SetGestureStatus, InkOverlay.SetGestureStatus o InkPicture.SetGestureStatus. Se un utente disegna un input penna simile a un movimento presente nell'elenco di alternative del riconoscimento, viene generato l'evento di movimento e l'input penna scompare, anche se il movimento non è la prima alternativa. Per evitare la scomparsa dell'input penna e annullare la raccolta del movimento, impostare la proprietà Cancel ereditata di InkCollectorGestureEventArgs su true se non si desidera che il riconoscimento risponda a tale evento.

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Informazioni sulla versione

.NET Framework

Supportato in: 3.0

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.Ink

InkCollector.CollectionMode

InkOverlay.CollectionMode

InkPicture.CollectionMode