InkPicture.SystemGesture-Ereignis

Artikel
06/13/2023

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 geben Informationen zum IInkCursor-Objekt , das zum Erstellen der Geste verwendet wird. Sie bieten auch Tastenkombinationen für Kombinationen von Mausereignissen und sind Möglichkeiten, Mausereignisse mit geringeren Auswirkungen auf die Leistung zu erkennen.

Anstatt z. B. nach einem MouseUp-Ereignis [InkPicture-Steuerelement]/MouseDown-Ereignispaar [InkPicture Control] zu suchen, in dem keine anderen Mausereignisse dazwischen auftreten, können Sie nach den Systemgesten Tap oder RightTap suchen.

Ein weiteres Beispiel: Anstatt auf MouseDown-Ereignis [InkPicture Control]/MouseMove Event [InkPicture Control] Ereignisse zu lauschen und zahlreiche MouseMove-Ereignismeldungen [InkPicture Control] zu erhalten, können Sie für die Drag- oder RightDrag-Systemgesten watch, solange Sie nicht an den (x, y) Koordinaten jeder Position der Maus interessiert sind. Dadurch können Sie anstelle zahlreicher MouseMove-Ereignismeldungen [InkPicture Control] 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

Weitere Informationen

Inkpicture
InkSystemGesture-Enumeration
Verwenden von Gesten

Freigeben über