Evento InkEdit.Gesture

Articolo
06/13/2023

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:

Aggiungere gestori eventi per gli eventi Gesture e Stroke .
Nel gestore eventi Gesture annullare l'evento Gesture per il movimento ed eseguire l'azione alternativa per il movimento.
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

Share via