KeyGesture Classe

Definizione

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

Ereditarietà

Object

InputGesture

KeyGesture

Attributi

TypeConverterAttribute

Esempio

Nell'esempio seguente viene illustrato come associare il Close comando a un KeyGesture oggetto usando un oggetto 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)

L'esempio seguente illustra come usare KeyGesture in XAML. Si noti che l'utilizzo di XAML non dichiara direttamente un <KeyGesture> elemento. L'utilizzo dell'elemento oggetto non è possibile perché KeyGesture non espone un costruttore pubblico senza parametri. L'utilizzo di XAML usa invece il comportamento typeconverter per dichiarare un intero inline come valore dell'attributo KeyGestureGesture .

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

Commenti

Nella maggior parte dei casi, un KeyGesture oggetto deve essere associato a uno o più ModifierKeys. Le eccezioni a questa regola sono i tasti funzione e i tasti numerici del tastierino, che possono essere validi KeyGesture da soli. Ad esempio, è possibile creare un KeyGesture oggetto usando solo il tasto F12, ma per usare la chiave X in un KeyGesture oggetto deve essere associato a un tasto di modifica.

È possibile usare un KeyBinding oggetto per associare un KeyGesture oggetto a un ICommandoggetto , in modo che il comando venga richiamato quando KeyGesture si verifica .

Per KeyGesture gli utilizzi XAML, la proprietà generalmente impostata in XAML è Gesture, nei casi in cui il movimento rappresenta sia una chiave standard che una chiave di modifica. È anche possibile impostare la Gesture proprietà come tasto funzione o solo una combinazione di tasti di modifica. Tuttavia, è più comune impostare la Key proprietà se l'associazione di comandi prevista è una chiave di funzione senza modificatori o Modifiers se l'associazione di comandi prevista è solo per i tasti di modifica.

Utilizzo degli attributi XAML

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

Valori XAML

functionKey Key

Un singolo valore di chiave, che deve essere uno dei tasti funzione (F1-12) o un tastierino numerico.

oneOrMoreModifierKeys Uno o più tasti di modifica, definiti dall'enumerazione ModifierKeys , delimitati da un carattere "+".

key Key

Valore di chiave singola.

Vedi anche

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