KeyGesture Classe

Referência

Definição

Namespace:: System.Windows.Input

Assembly:: PresentationCore.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Compartilhar via