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:
- 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 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 |
|
| Bibliothek |
|