InkOverlay.Gesture-Ereignis
Tritt auf, wenn eine anwendungsspezifische Geste erkannt wird.
Syntax
void Gesture(
[in] IInkCursor *Cursor,
[in] IInkStrokes *Strokes,
[in] VARIANT Gestures,
[in, out] VARIANT_BOOL *Cancel
);
Parameter
-
Cursor [in]
-
Das IInkCursor-Objekt , das das Gesture-Ereignis generiert hat.
-
Striche [in]
-
Die IInkStrokes-Auflistung , die die Erkennung als Geste zurückgegeben hat.
-
Gesten [in]
-
Ein Array von IInkGesture-Objekten in der Reihenfolge der Zuverlässigkeit von der Erkennung.
Weitere Informationen zur VARIANT-Struktur finden Sie unter Verwenden der COM-Bibliothek.
-
Abbrechen [ein, ausgehend]
-
Gibt an, ob die Auflistung dieser Geste abgebrochen werden soll, z. B. um die Freihandeingabe nicht zu löschen und das Stroke-Ereignis auszulösen.
Rückgabewert
Dieses Ereignis gibt keinen Wert zurück.
Bemerkungen
Diese Ereignismethode wird in den _IInkCollectorEvents- _IInkOverlayEvents- und _IInkPictureEvents dispatch-only-Schnittstellen (dispinterfaces) mit der ID DISPID_ICEGesture definiert.
Wenn die CollectionMode-Eigenschaft auf GestureOnly festgelegt ist, ist das Timeout zwischen dem Hinzufügen einer Geste durch einen Benutzer und dem Auftreten des Gestenereignisses ein fester Wert, den Sie programmgesteuert nicht ändern können. Die Gestenerkennung ist im InkAndGesture-Modus schneller.
So verhindern Sie die Sammlung von Freihandeingaben im InkAndGesture-Modus :
- Legen Sie CollectionMode auf InkAndGesture fest.
- Löschen Sie den Strich im Stroke-Ereignis .
- Verarbeiten Sie die Geste im Gestenereignis .
Um den Freihandfluss beim Gestikvorgang zu verhindern, legen Sie die DynamicRendering-Eigenschaft auf FALSE fest.
Zusätzlich zum Einfügen von Freihand wird das Gestenereignis ausgelöst, wenn es sich im Auswahl- oder Löschmodus befindet. Sie sind für die Nachverfolgung des Bearbeitungsmodus verantwortlich und sollten den Modus beachten, bevor Sie das Ereignis interpretieren.
Hinweis
Um Gesten zu erkennen, müssen Sie ein Objekt oder Steuerelement verwenden, das Freihandeingaben sammeln kann.
Anwendungsgesten werden als Gesten definiert, die in Ihrer Anwendung unterstützt werden.
Damit dieses Ereignis auftritt, muss das Objekt oder Steuerelement interesse an einer Reihe von Anwendungsgesten haben. Um das Interesse von Objekten oder Steuerelementen an einer Reihe von Gesten festzulegen, rufen Sie die SetGestureStatus-Methode des Objekts oder Steuerelements auf.
Eine Liste mit bestimmten Anwendungsgesten finden Sie unter InkApplicationGesture-Enumerationstyp .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Header |
|
| Bibliothek |
|