InkCollector.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- oder Radierermodus befindet. 1 gilt 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 Verknüpfungen zu Kombinationen von Mausereignissen und sind "kostengünstigere" Methoden zum Erkennen von Mausereignissen.
Anstatt beispielsweise nach einem MouseDown Event MouseDownEvent-Ereignispaar zu suchen, bei dem / keine anderen Mausereignisse dazwischen auftreten, können Sie nach den Systemgesten Tap oder RightTap suchen.
Ein weiteres Beispiel: Anstatt auf MouseDown Event / MouseMove Event-Ereignisse zu lauschen und zahlreiche MouseMove Event-Meldungen 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 der spezifischen 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 _ _ Dispatch-Only-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 |
|
| Bibliothek |
|