KeyGesture Classe

Definição

public ref class KeyGesture : System::Windows::Input::InputGesture

[System.ComponentModel.TypeConverter(typeof(System.Windows.Input.KeyGestureConverter))]
public class KeyGesture : System.Windows.Input.InputGesture

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Input.KeyGestureConverter))>]
type KeyGesture = class
    inherit InputGesture

Public Class KeyGesture
Inherits InputGesture

Herança

Object

InputGesture

KeyGesture

Atributos

TypeConverterAttribute

Exemplos

O exemplo a seguir mostra como associar o Close comando a um KeyGesture uso de um KeyBinding.

KeyGesture CloseCmdKeyGesture = new KeyGesture(
    Key.L, ModifierKeys.Alt);

KeyBinding CloseKeyBinding = new KeyBinding(
    ApplicationCommands.Close, CloseCmdKeyGesture);

this.InputBindings.Add(CloseKeyBinding);

Dim CloseCmdKeyGesture As New KeyGesture(Key.L, ModifierKeys.Alt)

Dim CloseKeyBinding As New KeyBinding(ApplicationCommands.Close, CloseCmdKeyGesture)

Me.InputBindings.Add(CloseKeyBinding)

O exemplo a seguir mostra como usar KeyGesture no XAML. Observe que o uso de XAML não declara diretamente um <KeyGesture> elemento. Esse uso de elemento de objeto não é possível porque KeyGesture não expõe um construtor público sem parâmetros. Em vez disso, o uso de XAML usa o comportamento do typeconverter para declarar uma linha inteira KeyGesture como o valor do Gesture atributo.

<Window.InputBindings>
  <KeyBinding Command="ApplicationCommands.Open"
              Gesture="CTRL+R" />
</Window.InputBindings>

Comentários

Na maioria dos casos, deve-se KeyGesture associar-se a um ou mais ModifierKeys. As exceções a essa regra são as chaves de função e as teclas de teclado numéricas, que podem ser válidas KeyGesture por si só. Por exemplo, você pode criar uma KeyGesture usando apenas a chave F12, mas para usar a chave X em uma KeyGesture chave deve ser emparelhada com uma chave modificadora.

Você pode usar um KeyBinding para associar um a um KeyGestureICommand, de modo que o comando seja invocado quando ocorrer KeyGesture .

Para KeyGesture usos XAML, a propriedade que geralmente é definida em XAML é Gesture, em casos em que o gesto representa uma chave padrão e uma chave modificadora. Você também pode definir a Gesture propriedade como apenas uma chave de função ou apenas uma combinação de chave modificadora. No entanto, é mais comum definir a Key propriedade se a associação de comando pretendida for uma chave de função sem modificadores ou Modifiers se a associação de comando pretendida for somente para chaves modificadoras.

Uso do atributo XAML

<object property="oneOrMoreModifierKeys+key"/>
- or -
<object property="functionKey"/>

Valores XAML

functionKey Key

Um valor de chave única, que deve ser uma das teclas de função (F1-12) ou teclas de teclado numéricas.

oneOrMoreModifierKeys Uma ou mais chaves modificadoras, definidas pela ModifierKeys enumeração, delimitadas com um caractere "+".

key Key

Um valor de chave única.

Confira também

• KeyBinding
• MouseBinding
• RoutedCommand
• CommandBinding
• MouseGesture
• InputBinding
• InputGesture