InkEdit.Gesture-Ereignis

Tritt auf, 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-Auflistung , die die IInkStrokeDisp-Objekte enthält, aus denen diese Geste besteht.

Gesten [in]

Ein Array von IInkGesture-Objekten in der Reihenfolge der Zuverlässigkeit.

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

Abbrechen [ein, aus]

Gibt an, ob die InkStrokes-Auflistung , aus der diese Geste besteht, abgebrochen werden soll, um die Freihandeingabe nicht zu löschen und das Stroke-Ereignis auszulösen.

Rückgabewert

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

Bemerkungen

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 das 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 Gestenereignis abgebrochen wird, wird das Stroke-Ereignis für die InkStrokes-Auflistung ausgelöst, die das Gestenereignis ausgelöst hat.

Damit dieses Ereignis auftritt, 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 im Enumerationstyp InkApplicationGesture .

Das InkEdit-Steuerelement erkennt mehrere Strichgesten nicht.

Das InkEdit-Steuerelement abonniert die folgenden Gesten.

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 Gestenereignis ausgelöst hat.

Anforderungen

Weitere Informationen

Inkedit

InkApplicationGesture-Enumeration

SetGestureStatus-Methode [InkEdit-Steuerelement]

RecoTimeout-Eigenschaft

Strichereignis [InkEdit-Steuerelement]

Verwenden von Gesten