KeyGesture.Matches(Object, InputEventArgs) Método

Definição

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Determina se este KeyGesture corresponde à entrada associada ao objeto InputEventArgs especificado.

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

Parâmetros

targetElement

Object

O destino.

inputEventArgs

InputEventArgs

Os dados de evento de entrada aos quais comparar esse gesto.

Retornos

Boolean

true se os dados do evento corresponderem a este KeyGesture; caso contrário, false.

Exemplos

O exemplo a seguir mostra como testar se um KeyGesture corresponde à entrada associada a uma instância de um InputEventArgs. Um KeyDown manipulador de eventos é criado que compara os dados do evento com o KeyGesture usando o Matches método .

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

Comentários

targetElement pode ser usado para tomar uma decisão mais específica sobre se um comando deve ser invocado em um elemento específico.