KeyGesture Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Input

Assembly:: PresentationCore.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Definisce una combinazione di tasti che può essere utilizzata per richiamare un 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

Ereditarietà: Object

InputGesture
KeyGesture

Attributi: TypeConverterAttribute

Esempio

Nell'esempio seguente viene illustrato come associare il Close comando a un KeyGesture oggetto usando un KeyBindingoggetto .

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)

Nell'esempio seguente viene illustrato come usare KeyGesture in XAML. Si noti che l'utilizzo XAML non dichiara direttamente un <KeyGesture> elemento. L'utilizzo dell'elemento oggetto non è possibile perché KeyGesture non espone un costruttore senza parametri pubblico. L'utilizzo 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 le chiavi di funzione e i tasti del tastierino numerico, che possono essere validi KeyGesture da soli. Ad esempio, è possibile creare un KeyGesture oggetto usando solo la chiave F12, ma per usare la chiave X in un oggetto deve essere associata a una KeyGesture chiave di modifica.

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

Per KeyGesture gli usi XAML, la proprietà impostata in genere in XAML è Gesture, nei casi in cui il movimento rappresenta sia una chiave standard che una chiave modificatore. È anche possibile impostare la Gesture proprietà per essere solo una chiave di funzione o semplicemente una combinazione di tasti di modifica. Tuttavia, è più comune impostare la proprietà se l'associazione Key di comandi prevista è una chiave di funzione senza modificatori o Modifiers se l'associazione di comandi prevista è solo per le chiavi del modificatore.

Uso della sintassi XAML per gli attributi

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

Valori XAML

functionKey
Key

Valore a chiave singola, che deve essere uno dei tasti di funzione (F1-12) o tasti numerici.

oneOrMoreModifierKeys
Una o più chiavi di modifica, definite dall'enumerazione ModifierKeys , delimitate con un carattere "+".

key
Key

Valore a chiave singola.

Costruttori

KeyGesture(Key)	Inizializza una nuova istanza della classe KeyGesture con l'oggetto Key specificato.
KeyGesture(Key, ModifierKeys)	Inizializza una nuova istanza della classe KeyGesture con gli oggetti Key e ModifierKeys specificati.
KeyGesture(Key, ModifierKeys, String)	Inizializza una nuova istanza della classe KeyGesture con gli oggetti Key e ModifierKeys specificati e la stringa di visualizzazione specificata.

Proprietà

DisplayString	Ottiene una rappresentazione in forma di stringa di questo oggetto KeyGesture.
Key	Ottiene il tasto associato a questo oggetto KeyGesture.
Modifiers	Ottiene i tasti di modifica associati con questo KeyGesture.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetDisplayStringForCulture(CultureInfo)	Restituisce una stringa che può essere utilizzata per visualizzare l'oggetto KeyGesture.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Matches(Object, InputEventArgs)	Determina se l'oggetto KeyGesture corrisponde all'input associato all'oggetto InputEventArgs specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a