InkOverlay.SystemGesture-Ereignis

Tritt ein, 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 Radierermodus befindet. 1 ist für den normalen Modus und 2 für radierermodus.

Rückgabewert

Dieses Ereignis gibt keinen Wert zurück.

Bemerkungen

Systemgesten sind nützlich, da sie Informationen über das IInkCursor-Objekt geben, das zum Erstellen der Geste verwendet wird. Sie bieten auch Verknüpfungen zu Kombinationen von Mausereignissen und sind "kostengünstigere" Möglichkeiten, Mausereignisse zu erkennen.

Anstatt beispielsweise nach einem MouseDown-Ereignispaarfür MouseUp-Ereignisse zu suchen, in dem keine anderen Mausereignisse dazwischen auftreten, können Sie nach den Systemgesten Tap oder / RightTap suchen.

Ein weiteres Beispiel: Anstatt auf MouseDownEvent MouseMove Event-Ereignisse zu lauschen und zahlreiche MouseMove-Ereignismeldungen zu erhalten, können Sie auf die Drag- oder RightDrag-Systemgesten achten, 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 mit bestimmten Systemgesten finden Sie unter InkSystemGesture-Enumerationstyp. Weitere Informationen zu Systemgesten finden Sie unter Verwenden von Gesten und Befehlseingabe auf dem Tablet PC.

Diese Ereignismethode wird in den _ Dispatch-Schnittstellen IInkCollectorEvents, _ IInkOverlayEvents und _ IInkPictureEvents (dispinterfaces) mit der ID DISPID _ ICESystemGesture definiert.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur Desktop-Apps der XP Tablet PC Edition []
Unterstützte Mindestversion (Server)
Nicht unterstützt
Header
Msinkaut.h (erfordert auch Msinkaut _ i.c)
Bibliothek
InkObj.dll

Weitere Informationen

InkOverlay-Klasse

InkSystemGesture-Enumeration

IInkCursor-Schnittstelle

Verwenden von Gesten

Stifteingabe, Ink und Erkennung

Befehlseingabe auf dem Tablet-PC