Evento InkPicture.Gesture
Si verifica quando viene riconosciuto un movimento 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]
-
Insieme IInkStrokes restituito dal riconoscitore come movimento.
-
Movimenti [in]
-
Matrice di oggetti IInkGesture , in ordine di attendibilità, dal riconoscitore.
Per altre informazioni sulla struttura VARIANT, vedere Uso della libreria COM.
-
Annulla [in, out]
-
VARIANT_TRUE se questo evento deve essere annullato, ad esempio non cancellare l'input penna e generare l'evento Stroke . In caso contrario, VARIANT_FALSE.
Valore restituito
Questo evento non restituisce un valore.
Commenti
Questo metodo di evento viene definito nei _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 in 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 a quando si inserisce l'input penna, l'evento Gesture viene generato quando si seleziona o cancella la modalità. L'utente è responsabile del rilevamento della modalità di modifica e deve essere a conoscenza della modalità prima di interpretare l'evento.
Nota
Per riconoscere i movimenti, è necessario usare un oggetto o un controllo in grado di raccogliere input penna.
I movimenti dell'applicazione vengono definiti come movimenti supportati all'interno dell'applicazione.
Affinché questo evento si verifichi, l'oggetto o il controllo deve avere interesse per un set di movimenti dell'applicazione. Per impostare gli oggetti o i controlli interessati a un set di movimenti, chiamare il metodo SetGestureStatus dell'oggetto o del controllo.
Per un elenco di movimenti specifici dell'applicazione, 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 |
|