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 seguinte mostra como associar o Close comando a KeyGesture a 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 seguinte mostra como usar KeyGesture em XAML. Note-se que o uso de XAML não declara diretamente um <KeyGesture> elemento. Esse uso de elementos de objeto não é possível porque KeyGesture não expõe um construtor público sem parâmetros. Em vez disso, a utilização de XAML utiliza o comportamento do typeconverter para declarar um inline inteiro KeyGesture como valor do Gesture atributo.

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

Observações

Na maioria dos casos, um KeyGesture deve estar associado a um ou mais ModifierKeys. As exceções a esta regra são as teclas de função e as teclas numéricas do teclado, que podem ser válidas KeyGesture por si só. Por exemplo, podes criar a KeyGesture usando apenas a tecla F12, mas para usar a tecla X em a KeyGesture tem de ser emparelhada com uma tecla modificadora.

Pode usar a KeyBinding para associar a KeyGesture a a ICommandum , de modo a que o comando seja invocado quando ocorre.KeyGesture

Para KeyGesture usos XAML, a propriedade geralmente definida em XAML é Gesture, nos casos em que o gesto representa tanto uma chave padrão como uma chave modificadora. Também podes definir a Gesture propriedade para ser apenas uma tecla de função, ou apenas uma combinação de teclas modificadoras. No entanto, é mais comum definir a Key propriedade se a ligação de comandos pretendida for uma tecla de função sem modificadores, ou Modifiers se a ligação de comandos pretendida for apenas para teclas modificadoras.

Uso de atributos XAML

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

Valores XAML

functionKey Key

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

oneOrMoreModifierKeys Uma ou mais teclas modificadoras, definidas pela ModifierKeys enumeração, delimitadas por um carácter "+".

key Key

Um único valor-chave.

Ver também

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