KeyGesture.Matches(Object, InputEventArgs) Methode

Definition

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Bestimmt, ob diese KeyGesture der Eingabe entspricht, die dem angegebenen InputEventArgs-Objekt zugeordnet ist.

public:
 override bool Matches(System::Object ^ targetElement, System::Windows::Input::InputEventArgs ^ inputEventArgs);

public override bool Matches (object targetElement, System.Windows.Input.InputEventArgs inputEventArgs);

override this.Matches : obj * System.Windows.Input.InputEventArgs -> bool

Public Overrides Function Matches (targetElement As Object, inputEventArgs As InputEventArgs) As Boolean

Parameter

targetElement

Object

Das Ziel.

inputEventArgs

InputEventArgs

Die Eingabeereignisdaten, mit denen diese Tastenkombination verglichen werden soll.

Gibt zurück

Boolean

true, wenn die Ereignisdaten dieser KeyGesture entsprechen, andernfalls false.

Beispiele

Im folgenden Beispiel wird gezeigt, wie getestet wird, ob mit KeyGesture der Eingabe übereinstimmt, die einem instance eines InputEventArgszugeordnet ist. Es wird ein KeyDown Ereignishandler erstellt, der die Ereignisdaten mit der KeyGesture - Matches Methode vergleicht.

private void OnKeyDown(object sender, KeyEventArgs e)
{
    KeyGesture keyGesture = new KeyGesture(Key.B, ModifierKeys.Control);

    if(keyGesture.Matches(null, e))
    {
        MessageBox.Show("Trapped Key Gesture");
    }
}

Private Overloads Sub OnKeyDown(ByVal sender As Object, ByVal e As KeyEventArgs)
    Dim keyGesture As New KeyGesture(Key.B, ModifierKeys.Control)

    If keyGesture.Matches(Nothing, e) Then
        MessageBox.Show("Trapped Key Gesture")
    End If
End Sub

Hinweise

targetElement kann verwendet werden, um eine spezifischere Entscheidung darüber zu treffen, ob ein Befehl für ein bestimmtes Element aufgerufen werden soll.