Metodo IInkOverlay::get_CollectionMode (msinkaut.h)

Articolo
03/08/2023

Ottiene o imposta la modalità di raccolta che determina se l'input penna, il movimento o entrambi vengono riconosciuti come scritti dall'utente.

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT get_CollectionMode(
  InkCollectionMode *Mode
);

Parametri

Mode

Valore restituito

nessuno

Osservazioni

Per un elenco delle modalità che è possibile usare, vedere il tipo di enumerazione InkCollectionMode . Tuttavia, quando si usa la proprietà CollectionMode in un sistema con Microsoft Windows? XP Tablet PC Edition Software Development Kit (SDK) installato, ma non è installato il sistema di riconoscimento, la modalità non può essere impostata su GestureOnly o InkAndGesture.

Nota L'oggetto InkCollector , l'oggetto InkOverlay o il controllo InkPicture genera un errore se si tenta di modificare la proprietà CollectionMode durante la raccolta dell'input penna. Per evitare questo conflitto, controllare la proprietà CollectInk prima di modificare la proprietà CollectionMode .

Per ognuno dei valori CollectionMode si verificano i comportamenti seguenti:

Modalità InkOnly

Viene raccolto solo l'input penna; i movimenti non sono.
L'interesse per l'evento Gesture è impostato su FALSE (tutti gli altri interessi degli eventi rimangono invariati).

Modalità GestureOnly

Vengono raccolti solo i gesti; l'input penna non è. I tratti vengono eliminati dopo l'invio al riconoscimento movimento.
L'interesse dell'evento Movimento è impostato su TRUE (tutti gli altri interessi degli eventi rimangono invariati).
L'agente di raccolta input penna non attiva gli eventi correlati a tratti e pacchetti seguenti: gli eventi CursorDown, Stroke, NewPackets e NewInAirPackets .
Gli eventi del cursore vengono attivati.
L'input penna viene sempre eliminato.

Modalità InkAndGesture

Vengono raccolti sia input penna che movimenti.
Vengono riconosciuti solo i movimenti a tratto singolo.
L'interesse dell'evento Movimento è impostato su TRUE (tutti gli altri interessi degli eventi rimangono invariati).
L'evento Gesture viene generato per primo, consentendo di accettare o annullare il movimento. Per annullare il movimento, impostare il parametro Cancel su TRUE. L'annullamento del movimento forza l'agente di raccolta input penna a raccogliere l'input penna.

La modifica della modalità di raccolta non modifica lo stato dei singoli movimenti.

Il comportamento indesiderato può verificarsi quando CollectionMode è impostato su InkAndGesture e l'interesse di un oggetto/controllo in un movimento noto è impostato (chiamando il metodo SetGestureStatus ). Se si disegna l'input penna simile al gesto noto e il gesto noto si trova nell'elenco di alternative del riconoscitore, l'evento Gesture viene generato e l'input penna scompare, anche se il gesto non è l'alternativa superiore. Per evitare che l'input penna scompaia e annulla la raccolta del movimento, impostare il parametro Cancel su TRUE se l'evento è uno di cui non si è interessati.

Quando CollectionMode è impostato su GestureOnly, 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 la proprietà CollectionMode su InkAndGesture.
Nell'evento Stroke eliminare il tratto.
Nell'evento Gesture elaborare il movimento.
Impostare DynamicRendering su FALSE per impedire il flusso dell'input penna durante la gesturing.

Requisiti


Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	msinkaut.h
Libreria	InkObj.dll