Condividi tramite


Evento InkEdit.Gesture

Si verifica quando viene riconosciuto un movimento dell'applicazione.

Sintassi

HRESULT Gesture(
  [in]      IInkCursor   *Cursor,
  [in]      IInkStrokes  *Strokes,
  [in]      VARIANT      Gestures,
  [in, out] VARIANT_BOOL *Cancel
);

Parametri

Cursore [in]

Oggetto IInkCursor usato per creare questo gesto.

Tratti [in]

Insieme InkStrokes che contiene gli oggetti IInkStrokeDisp che costituiscono questo movimento.

Movimenti [in]

Matrice di oggetti IInkGesture , in ordine di attendibilità.

Per altre informazioni sulla struttura VARIANT, vedere Uso della libreria COM.

Annulla [in, out]

Se l'insieme InkStrokes che costituisce questo movimento deve essere annullato, in modo da non cancellare l'input penna e per generare l'evento Stroke .

Valore restituito

Se questo evento ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo di evento viene definito nell'interfaccia _IInkEditEvents . L'interfaccia _IInkEditEvents implementa l'interfaccia IDispatch con un identificatore di DISPID_IeeGesture.

Viene generato un evento Gesture solo se l'ultima chiamata al metodo Recognize o all'ultima attivazione del timeout del riconoscimento è il primo oggetto IInkStrokeDisp dall'ultima chiamata al metodo Recognize o all'ultima attivazione del timeout di riconoscimento.

Se l'evento Gesture viene annullato, l'evento Stroke viene generato per l'insieme InkStrokes che ha generato l'evento Gesture .

Per eseguire questo evento, il controllo InkEdit deve sottoscrivere un set di movimenti dell'applicazione. Per impostare l'interesse del controllo InkEdit in un set di movimenti, chiamare il metodo SetGestureStatus .

Per un elenco di movimenti dell'applicazione, vedere il tipo di enumerazione InkApplicationGesture .

Il controllo InkEdit non riconosce più movimenti di tratto.

Il controllo InkEdit sottoscrive i movimenti seguenti.

Movimento Azione
Verso il basso a sinistra, lungo a sinistra
Immettere
Destra
Space
Sinistra
Backspace
Up-right, Up-right-long
Scheda

Per modificare l'azione predefinita per un movimento:

  1. Aggiungere gestori eventi per gli eventi Gesture e Stroke .
  2. Nel gestore eventi Gesture annullare l'evento Gesture per il movimento ed eseguire l'azione alternativa per il movimento.
  3. Nel gestore eventi Stroke annullare l'evento Stroke per l'oggetto IInkStrokeDisp che ha generato l'evento Gesture annullato.

Requisiti

Requisito Valore
Client minimo supportato
Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato
Nessuno supportato
Intestazione
Inked.h (richiede anche inked_i.c)
Libreria
InkEd.dll

Vedi anche

Inkedit

Enumerazione InkApplicationGesture

Metodo SetGestureStatus [Controllo InkEdit]

RecoTimeout, proprietà

Evento Stroke [Controllo InkEdit]

Uso dei movimenti