InkPicture.SystemGesture-Ereignis

Artikel
11/26/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 InkPicture
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.

Anstatt ein aus dem MouseUp-Ereignis und dem MouseDown-Ereignis bestehendes Ereignispaar ohne dazwischenliegende andere Mausereignisse zu überwachen, können Sie z. B. die Tap-Systemstiftbewegung oder die RightTap-Systemstiftbewegung überwachen.

Solange Sie nicht die (x,y-) Koordinaten jeder Mausposition benötigen, könnten Sie z. B. auch die Drag-Systemstiftbewegung oder die RightDrag-Systemstiftbewegung anstelle des MouseDown-Ereignisses und des MouseMove-Ereignisses überwachen, bei denen Sie zahlreiche MouseMove-Meldungen erhalten. Dies ermöglicht es Ihnen, nur eine Meldung statt zahlreicher MouseMove-Meldungen zu empfangen.

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

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 InkPicture-Objekt mit dem Namen mInkPicture den Ereignishandler.

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

// register the SystemGesture event handler
mInkPicture.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.