InkEdit.Gesture-Ereignis

Artikel
10/28/2008

Tritt ein, wenn eine Anwendungsstiftbewegung erkannt wird.

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

Syntax

'Declaration
Public Event Gesture As InkEditGestureEventHandler
'Usage
Dim instance As InkEdit
Dim handler As InkEditGestureEventHandler

AddHandler instance.Gesture, handler

public event InkEditGestureEventHandler Gesture

public:
 event InkEditGestureEventHandler^ Gesture {
    void add (InkEditGestureEventHandler^ value);
    void remove (InkEditGestureEventHandler^ value);
}

/** @event */
public void add_Gesture (InkEditGestureEventHandler value)
/** @event */
public void remove_Gesture (InkEditGestureEventHandler value)

JScript unterstützt keine Ereignisse.

Hinweise

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

Beim Erstellen eines InkEditGestureEventHandler-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.

Damit dieses Ereignis eintritt, muss das InkEdit-Steuerelement Interesse an einem Satz von Anwendungsstiftbewegungen haben. Rufen Sie die InkEdit.SetGestureStatus-Methode auf, um das Interesse des InkEdit-Steuerelements für einen Satz an Stiftbewegungen festzulegen. Das InkEdit-Steuerelement erkennt keine Stiftbewegungen mit mehreren Strichen.

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

Das InkEdit-Steuerelement hat standardmäßig Interesse an und Aktionen für die folgenden Stiftbewegungen.

Stiftbewegung	Aktion
Nach unten links, nach unten links lang	Eingabetaste
Recht	Leerzeichen
Links	Rücktaste
Nach oben rechts, nach oben rechts lang	TAB

Im InkEdit-Steuerelement wird ein Gesture-Ereignis nur dann ausgelöst, wenn die Stiftbewegung der erste Strich seit dem letzten Aufruf der Recognize-Methode oder der letzten Auslösung des Timeout bei der Erkennung war.

Wird das Gesture-Ereignis abgebrochen, wird das Stroke-Ereignis für die Stroke-Objekte ausgelöst, die das Gesture-Ereignis ausgelöst haben.

So ändern Sie die Standardaktion für eine Stiftbewegung

Fügen Sie Ereignishandler für die Gesture- und Stroke-Ereignisse hinzu.
Brechen Sie im Gesture-Ereignishandler das Gesture-Ereignis für die Stiftbewegung ab, und führen Sie die alternative Aktion für die Stiftbewegung durch.
Brechen Sie im Stroke-Ereignishandler das Stroke-Ereignis für das Stroke-Objekt ab, das das abgebrochene Gesture-Ereignis ausgelöst hat.

Beispiele

In diesem Beispiel wird veranschaulicht, wie Sie das Gesture-Ereignis und das Stroke-Ereignis abonnieren können, um die Funktionalität einer ApplicationGesture zu erweitern.

Wenn das Gesture-Ereignis ausgelöst wird, werden die Stiftbewegung und der aktuelle Zustand des InkEdit-Steuerelements untersucht. Gegebenenfalls wird das Verhalten der Stiftbewegung geändert, und das Ereignis wird abgebrochen.

Private Sub mInkEdit_Gesture(ByVal sender As Object, ByVal e As InkEditGestureEventArgs)
    ' There might be more than one gesture passed in InkEditGestureEventArgs
    ' The gestures are arranged in order of confidence from most to least
    ' This event handler is only concerned with the first (most confident) gesture
    ' and only if the gesture is ApplicationGesture.Left with strong confidence
    Dim G As Gesture = e.Gestures(0)
    If (ApplicationGesture.Left = G.Id And RecognitionConfidence.Strong = G.Confidence) Then
        Dim pInkEdit As InkEdit = DirectCast(sender, InkEdit)
        ' by default, ApplicationGesture.Left maps to Backspace
        ' If the insertion point is at the beginning of the text
        ' and there is no text selected, then Backspace does not do anything.
        ' In this case, we will alter the gesture to map to Delete instead
        If (0 = pInkEdit.SelectionStart And 0 = pInkEdit.SelectionLength And pInkEdit.Text.Length > 0) Then
            ' take out the first character of the string
            pInkEdit.Text = pInkEdit.Text.Remove(0, 1)
            ' save the stroke ID in a class level var for use in the Stroke event
            Me.mStrokeID = e.Strokes(0).Id
            ' cancel the gesture so it won't perform the default action
            e.Cancel = True
        End If
    End If
End Sub

private void mInkEdit_Gesture(object sender, InkEditGestureEventArgs e)
{
    // There might be more than one gesture passed in InkEditGestureEventArgs
    // The gestures are arranged in order of confidence from most to least
    // This event handler is only concerned with the first (most confident) gesture
    // and only if the gesture is ApplicationGesture.Left with strong confidence
    Gesture G = e.Gestures[0];
    if (ApplicationGesture.Left == G.Id &&  RecognitionConfidence.Strong == G.Confidence)
    {
        InkEdit pInkEdit = (InkEdit)sender;

        // by default, ApplicationGesture.Left maps to Backspace
        // If the insertion point is at the beginning of the text
        // and there is no text selected, then Backspace does not do anything.
        // In this case, we will alter the gesture to map to Delete instead
        if (0 == pInkEdit.SelectionStart && 0 == pInkEdit.SelectionLength && pInkEdit.Text.Length > 0)
        {
            // take out the first character of the string
            pInkEdit.Text = pInkEdit.Text.Remove(0, 1);
            // save the stroke ID in a class level var for use in the Stroke event
            this.mStrokeID = e.Strokes[0].Id;
            // cancel the gesture so it won't perform the default action
            e.Cancel = true;
        }
    }
}

Wenn das Stroke-Ereignis für den Strich ausgelöst wird, mit dem die Stiftbewegung generiert wurde, deren Verhalten im Gesture-Ereignis geändert wurde, wird das Ereignis abgebrochen. Dies verhindert das Rendern des Strichs.

Private Sub mInkEdit_Stroke(ByVal sender As Object, ByVal e As InkEditStrokeEventArgs)
    e.Cancel = (e.Stroke.Id = Me.mStrokeID)
End Sub

private void mInkEdit_Stroke(object sender, InkEditStrokeEventArgs e)
{
    e.Cancel = (e.Stroke.Id == this.mStrokeID);
}

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.