InkOverlay.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 über das 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 / mit Ereignissen zu suchen, bei denen keine anderen Mausereignisse dazwischen auftreten, können Sie nach den Systemgesten Tap oder RightTap suchen.
Ein weiteres Beispiel: Anstatt auf MouseDown Event / MouseMove-Ereignisereignisse zu lauschen und zahlreiche MouseMove-Ereignismeldungen zu erhalten, können Sie für die Drag- oder RightDrag-Systemgesten watch, solange Sie nicht an den Koordinaten (x, y) 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 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 |
|
| Bibliothek |
|