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.
| Geste | Aktion |
|---|---|
| Unten links, Unten links lang |
EINGABETASTE |
| Right |
LeerZchn |
| Links |
Rücktaste |
| Up-right, Up-right-long |
Registerkarte |
So ändern Sie die Standardaktion für eine Geste:
- Fügen Sie Ereignishandler für die Gesten - und Strichereignisse hinzu.
- Brechen Sie im Gestenereignishandler das Gestenereignis für die Geste ab, und führen Sie die alternative Aktion für die Geste aus.
- Brechen Sie im Stroke-Ereignishandler das Stroke-Ereignis für das IInkStrokeDisp-Objekt ab, das das abgebrochene Gestenereignis ausgelöst hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Header |
|
| Bibliothek |
|