Evento InkCollector.Gesture
Si verifica quando viene riconosciuto un gesto specifico dell'applicazione.
Sintassi
void Gesture(
[in] IInkCursor *Cursor,
[in] IInkStrokes *Strokes,
[in] VARIANT Gestures,
[in, out] VARIANT_BOOL *Cancel
);
Parametri
-
Cursore [in]
-
Oggetto IInkCursor che ha generato l'evento Gesture .
-
Tratti [in]
-
Raccolta IInkStrokes restituita dal riconoscimento come movimento.
-
Movimenti [in]
-
Matrice di oggetti IInkGesture , in ordine di attendibilità, dal riconoscimento.
Per altre informazioni sulla struttura VARIANT, vedere Uso della libreria COM.
-
Annulla [in, out]
-
VARIANT_TRUE se questo gesto deve essere annullato; in caso contrario, VARIANT_FALSE.
Valore restituito
Questo evento non restituisce un valore.
Commenti
Questo metodo di evento viene definito nella _IInkCollectorEvents, _IInkOverlayEvents e _IInkPictureEvents interfacce di sola distribuzione (dispinterfaces) con un ID di DISPID_ICEGesture.
Quando la proprietà CollectionMode è impostata su GestureOnly, il timeout tra quando un utente aggiunge un movimento e quando si verifica l'evento Gesture è un valore fisso che non è possibile modificare a livello di codice. Il riconoscimento dei movimenti è più veloce in modalità InkAndGesture .
Per impedire la raccolta di input penna durante la modalità InkAndGesture :
- Impostare CollectionMode su InkAndGesture.
- Eliminare il tratto nell'evento Stroke .
- Elaborare il movimento nell'evento Gesture .
Per impedire il flusso di input penna durante la gesturing, impostare la proprietà DynamicRendering su FALSE.
Oltre all'inserimento dell'input penna, l'evento Gesture viene attivato quando si seleziona o si cancella la modalità. È responsabile del rilevamento della modalità di modifica e deve essere consapevole della modalità prima di interpretare l'evento.
Nota
Per riconoscere i movimenti, è necessario usare un oggetto o un controllo che può raccogliere input penna.
I movimenti dell'applicazione sono definiti come movimenti supportati all'interno dell'applicazione.
Affinché questo evento si verifichi, l'oggetto o il controllo devono avere interesse in un set di movimenti dell'applicazione. Per impostare gli oggetti o i controlli interessati in un set di movimenti, chiamare il metodo SetGestureStatus dell'oggetto o del controllo.
Per un elenco di movimenti di applicazione specifici, vedere il tipo di enumerazione InkApplicationGesture .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows XP Tablet PC Edition [solo app desktop] |
| Server minimo supportato |
Nessuno supportato |
| Intestazione |
|
| Libreria |
|