InkEdit.Gesture-Ereignis

Tritt ein, wenn eine Anwendungsgeste erkannt wird.

Syntax

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

Parameter

Cursor [ In]

Das IInkCursor-Objekt, das zum Erstellen dieser Geste verwendet wurde.

Striche [ In]

Die InkStrokes-Sammlung, die die IInkStrokeDisp-Objekte enthält, aus denen diese Geste besteht.

Gesten [ In]

Ein Array von IInkGesture-Objekten in der Reihenfolge der Konfidenz.

Weitere Informationen zur VARIANT-Struktur finden Sie unter Verwenden der COM-Bibliothek.

Abbrechen [ in, out]

Gibt an, ob die InkStrokes-Sammlung, die diese Geste bildet, abgebrochen werden soll, damit die Ink-Sammlung nicht gelöscht und das Stroke-Ereignis ausgelöst wird.

Rückgabewert

Wenn dieses Ereignis erfolgreich ist, wird S _ OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Diese Ereignismethode wird in der _ IInkEditEvents-Schnittstelle definiert. Die _ IInkEditEvents-Schnittstelle implementiert die IDispatch-Schnittstelle mit dem Bezeichner DISPID _ IeeGesture.

Ein Gestenereignis wird nur ausgelöst, wenn IInkStrokeDisp für das IInkGesture-Objekt das erste IInkStrokeDisp-Objekt seit dem letzten Aufruf der Recognize-Methode oder dem letzten Auslösen des Erkennungstimeouts ist.

Wenn das Gesture-Ereignis abgebrochen wird, wird das Stroke-Ereignis für die InkStrokes-Auflistung ausgelöst, die das Gesture-Ereignis ausgelöst hat.

Damit dieses Ereignis eintritt, muss das InkEdit-Steuerelement eine Reihe von Anwendungsgesten abonnieren. Um das Interesse des InkEdit-Steuerelements an einer Reihe von Gesten festzulegen, rufen Sie die SetGestureStatus-Methode auf.

Eine Liste der Anwendungsgesten finden Sie unter InkApplicationGesture-Enumerationstyp.

Das InkEdit-Steuerelement erkennt nicht mehrere Strichgesten.

Das InkEdit-Steuerelement abonniert die folgenden Gesten.

Geste Aktion
Links unten, links unten– lang
EINGABETASTE
Right
LeerZchn
Links
Rückschritt
Up-right, Up-right-long
Registerkarte

So ändern Sie die Standardaktion für eine Geste:

  1. Fügen Sie Ereignishandler für die Gesten- und Strichereignisse hinzu.
  2. Brechen Sie im Gestenereignishandler das Gestenereignis für die Geste ab, und führen Sie die alternative Aktion für die Geste aus.
  3. Brechen Sie im Stroke-Ereignishandler das Stroke-Ereignis für das IInkStrokeDisp-Objekt ab, das das abgebrochene Gesture-Ereignis ausgelöst hat.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur Desktop-Apps der XP Tablet PC Edition []
Unterstützte Mindestversion (Server)
Nicht unterstützt
Header
Inked.h (erfordert auch inked _ i.c)
Bibliothek
InkEd.dll

Siehe auch

Inkedit

InkApplicationGesture-Enumeration

SetGestureStatus-Methode [ inkEdit-Steuerelement]

RecoTimeout-Eigenschaft

Stroke Event [ InkEdit-Steuerelement]

Verwenden von Gesten