KeyGesture Classe

  • Referência

Definição

Namespace:
System.Windows.Input
Assembly:
PresentationCore.dll

Define um gesto de entrada de teclado que pode ser usado para invocar um comando.

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 usando 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 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, um KeyGesture deve ser associado a um ou mais ModifierKeys. As exceções a essa regra são as chaves de função e as teclas numéricas do teclado, que podem ser válidas KeyGesture por si só. Por exemplo, você pode criar um KeyGesture usando apenas a chave F12, mas para usar a chave X em um KeyGesture , ela deve ser emparelhada com uma chave modificadora.

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

Para KeyGesture usos XAML, a propriedade que geralmente é definida em XAML é Gesture, nos 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 teclas 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 apenas para chaves modificadoras.

Uso do Atributo XAML

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

Valores XAML

functionKey
Key

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

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

key
Key

Um único valor de chave.

Construtores

KeyGesture(Key)

Inicializa uma nova instância da classe KeyGesture com o Key especificado.
KeyGesture(Key, ModifierKeys)

Inicializa uma nova instância da classe KeyGesture com o Key e ModifierKeys especificados.
KeyGesture(Key, ModifierKeys, String)

Inicializa uma nova instância da classe KeyGesture com a cadeia de caracteres de exibição, Key e ModifierKeys especificados.

Propriedades

DisplayString

Obtém uma representação da cadeia de caracteres desse KeyGesture.
Key

Obtém a chave associada a este KeyGesture.
Modifiers

Obtém as teclas modificadoras associadas a este KeyGesture.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetDisplayStringForCulture(CultureInfo)

Retorna uma cadeia de caracteres que pode ser usada para exibir o KeyGesture.
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Matches(Object, InputEventArgs)

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

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também