Condividi tramite


Metodo IInkCollector::get_CollectionMode (msinkaut.h)

Ottiene o imposta la modalità raccolta che determina se l'input penna, il movimento o entrambi vengono riconosciuti come scrive l'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 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à CollectionInk prima di modificare la proprietà CollectionMode .
 
I comportamenti seguenti si verificano per ognuno dei valori CollectionMode :

Modalità InkOnly

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

Modalità GestureOnly

  • Vengono raccolti solo i movimenti; l'input penna non è. I tratti vengono eliminati dopo l'invio al riconoscimento dei movimenti.
  • L'interesse dell'evento Gesture è impostato su TRUE (tutti gli altri interessi dell'evento rimangono invariati).
  • L'agente di raccolta input penna non genera gli eventi correlati al tratto e ai pacchetti seguenti: 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 Gesture è impostato su TRUE (tutti gli altri interessi dell'evento rimangono invariati).
  • L'evento Gesture viene generato prima, 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 per raccogliere l'input penna.
La modifica della modalità 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 viene impostato (chiamando il metodo SetGestureStatus ). Se si disegna inchiostro simile al gesto noto e il movimento noto si trova nell'elenco di alternative del riconoscimento, l'evento Movimento viene generato e l'input penna scompare, anche se il movimento non è l'alternativa superiore. Per impedire la scomparsa dell'input penna e l'annullamento della raccolta del movimento, impostare il parametro Cancel su TRUE se l'evento è uno di cui non si ha alcun interesse.

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 impedire la raccolta di input penna durante la modalità InkAndGesture , è possibile:

  1. Impostare la proprietà CollectionMode su InkAndGesture.
  2. Nell'evento Stroke eliminare il tratto.
  3. Nell'evento Gesture elaborare il movimento.
  4. Impostare DynamicRendering su FALSE per impedire il flusso di input penna durante la gestione.

Requisiti

Requisito Valore
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

Vedi anche

CollectInk, proprietà

Proprietà Enabled

IInkCollector

Enumerazione InkCollectionMode

Classe InkCollector