Metodo IInkOverlay::get_CollectionMode (msinkaut.h)
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.
- 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).
- 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.
- 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.
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 |