InkCollector.SystemGesture-Ereignis

Tritt auf, wenn eine Systemgeste erkannt wird.

Syntax

void SystemGesture(
  [in] IInkCursor       *Cursor,
  [in] InkSystemGesture Id,
  [in] long             X,
  [in] long             Y,
  [in] long             Modifier,
  [in] BSTR             Character,
  [in] long             CursorMode
);

Parameter

Cursor [in]

Das IInkCursor-Objekt , das das SystemGesture-Ereignis generiert hat.

ID [in]

Der Wert der Systemgeste.

X [in]

Die x-Koordinate der Position der Geste.

Y [in]

Die y-Koordinate der Position der Geste.

Modifizierer [in]

Reserviert.

Zeichen [in]

Reserviert.

CursorMode [in]

Ein Wert, der angibt, ob sich das IInkCursor-Objekt im normalen Modus oder im Radierermodus befindet. 1 ist für den normalen Modus und 2 für den Radierermodus.

Rückgabewert

Dieses Ereignis gibt keinen Wert zurück.

Bemerkungen

Systemgesten sind nützlich, da sie Informationen zum IInkCursor-Objekt liefern, das zum Erstellen der Geste verwendet wird. Sie bieten auch Tastenkombinationen für Kombinationen von Mausereignissen und sind "billigere" Möglichkeiten, Mausereignisse zu erkennen.

Anstatt beispielsweise nach einemMouseUp-Ereignis-MouseDown-Ereignispaar / zu suchen, bei dem keine anderen Mausereignisse dazwischen auftreten, können Sie nach den Systemgesten Tap oder RightTap suchen.

Ein weiteres Beispiel: Anstatt mouseDown Event / MouseMove Ereignisereignisse zu lauschen und zahlreiche MouseMove-Ereignismeldungen zu erhalten, können Sie watch für die Systemgesten drag or RightDrag system, solange Sie nicht an den (x, y) Koordinaten jeder Position der Maus interessiert sind. Dadurch können Sie anstelle zahlreicher MouseMove-Ereignismeldungen nur eine Nachricht empfangen.

Eine Liste der spezifischen Systemgesten finden Sie im Enumerationstyp InkSystemGesture . Weitere Informationen zu Systemgesten finden Sie unter Verwenden von Gesten und Befehlseingaben auf dem Tablet-PC.

Diese Ereignismethode wird in den _IInkCollectorEvents-, _IInkOverlayEvents- und _IInkPictureEvents Dispatch-only-Schnittstellen (dispinterfaces) mit der ID DISPID_ICESystemGesture definiert.

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

InkCollector-Klasse

InkSystemGesture-Enumeration

IInkCursor-Schnittstelle

Verwenden von Gesten

Stifteingabe, Freihandeingabe und Erkennung

Befehlseingabe auf dem Tablet-PC