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 :

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
Msinkaut.h (richiede anche Msinkaut_i.c)
Libreria
InkObj.dll

Vedi anche

Inkpicture

Enumerazione InkApplicationGesture

SetGestureStatus, metodo

Uso dei movimenti