InkPicture.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 Gestenereignis 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, aus]
-
VARIANT_TRUE , wenn dieses Ereignis abgebrochen werden soll, z. B. um die Freihandeingabe nicht zu löschen und das Stroke-Ereignis auszulösen. Andernfalls VARIANT_FALSE.
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 Freihand 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 Fluss von Freihand 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 kennen, bevor Sie das Ereignis interpretieren.
Hinweis
Um Gesten zu erkennen, müssen Sie ein Objekt oder Steuerelement verwenden, das Freihand 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 die Objekte oder Steuerelemente für eine Reihe von Gesten festzulegen, rufen Sie die SetGestureStatus-Methode des -Objekts oder -Steuerelements auf.
Eine Liste der spezifischen Anwendungsgesten finden Sie im Enumerationstyp InkApplicationGesture .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Header |
|
| Bibliothek |
|