InkOverlay.SystemGesture-Ereignis

Artikel
10/28/2008

Tritt ein, wenn eine Systemstiftbewegung erkannt wird.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Event SystemGesture As InkCollectorSystemGestureEventHandler
'Usage
Dim instance As InkOverlay
Dim handler As InkCollectorSystemGestureEventHandler

AddHandler instance.SystemGesture, handler

public event InkCollectorSystemGestureEventHandler SystemGesture

public:
 event InkCollectorSystemGestureEventHandler^ SystemGesture {
    void add (InkCollectorSystemGestureEventHandler^ value);
    void remove (InkCollectorSystemGestureEventHandler^ value);
}

/** @event */
public void add_SystemGesture (InkCollectorSystemGestureEventHandler value)
/** @event */
public void remove_SystemGesture (InkCollectorSystemGestureEventHandler value)

JScript unterstützt keine Ereignisse.

Hinweise

Systemstiftbewegungen liefern Informationen zum Cursor-Objekt, mit dem die Stiftbewegung erstellt wird. Sie stellen außerdem Verknüpfungen mit Kombinationen von Mausereignissen bereit, und sie ermöglichen eine effiziente Erkennung von Mausereignissen.

Statt beispielsweise zu überwachen, ob ein Paar von MouseUp- und MouseDown-Ereignissen ohne dazwischenliegende andere Mausereignisse eintritt, können Sie die Tap-Systemstiftbewegung oder die RightTap-Systemstiftbewegung überwachen.

Ein weiteres Beispiel: Solange Sie nicht die (x,y)-Koordinaten jeder Mausposition benötigen, können Sie auch die Drag-Systemstiftbewegung oder die RightDrag-Systemstiftbewegung anstelle der MouseDown- und MouseMove-Ereignisse überwachen, bei denen Sie zahlreiche MouseMove-Meldungen erhalten. Auf diese Weise empfangen Sie nur eine Meldung statt zahlreicher MouseMove-Meldungen.

Eine Liste der spezifischen Systemstiftbewegungen finden Sie unter dem SystemGesture-Enumerationstyp. Weitere Informationen zu Systemstiftbewegungen finden Sie unter Command Input on the Tablet PC und Using Gestures.

Der Ereignishandler empfängt ein Argument vom Typ InkCollectorSystemGestureEventArgs, das Daten zu diesem Ereignis enthält.

Beim Erstellen eines InkCollectorSystemGestureEventHandler-Delegaten bestimmen Sie die Methode für die Ereignisbehandlung. Um dem Ereignishandler das Ereignis zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu. Der Ereignishandler wird bei jedem Eintreten des Ereignisses aufgerufen, sofern der Delegat nicht entfernt wird.

Beispiele

Der Ereignishandler in diesem Beispiel zeigt Informationen zu Systemstiftbewegungen in einer Bezeichnung auf der Statusleiste (statusLabelSysGesture) an.

Private Sub Event_OnSystemGesture(ByVal sender As Object, ByVal e As InkCollectorSystemGestureEventArgs)
    Select Case e.Id
        Case SystemGesture.Tap
            Me.statusLabelSysGesture.Text = "Tap"
        Case SystemGesture.DoubleTap
            Me.statusLabelSysGesture.Text = "Double Tap"

    End Select
End Sub

private void Event_OnSystemGesture(object sender, InkCollectorSystemGestureEventArgs e)
{
    switch (e.Id)
    {
        case SystemGesture.Tap:
            this.statusLabelSysGesture.Text = "Tap";
            break;
        case SystemGesture.DoubleTap:
            this.statusLabelSysGesture.Text = "Double Tap";
            break;
    }

}

Vor dem Erfassen von Systemstiftbewegungen registriert das InkOverlay-Objekt mit dem Namen mInkOverlay den Ereignishandler.

' register the SystemGesture event handler
AddHandler mInkOverlay.SystemGesture, New InkCollectorSystemGestureEventHandler(AddressOf Event_OnSystemGesture)

// register the SystemGesture event handler
mInkOverlay.SystemGesture += new InkCollectorSystemGestureEventHandler(Event_OnSystemGesture);

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.