InkPicture.Gesture-Ereignis

  • Artikel

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 :

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
msinkaut.h (erfordert auch Msinkaut_i.c)
Bibliothek
InkObj.dll

Siehe auch

Inkpicture

InkApplicationGesture-Enumeration

SetGestureStatus-Methode

Verwenden von Gesten