KeyGesture Classe

Definizione

Definisce una combinazione di tasti che può essere utilizzata per richiamare un comando.Defines a keyboard combination that can be used to invoke a command.

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à
KeyGesture
Attributi

Esempio

Nell'esempio seguente viene illustrato come associare il Close comando a un oggetto KeyGesture utilizzando un oggetto KeyBinding .The following example shows how to bind the Close command to a KeyGesture using a 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)

Nell'esempio seguente viene illustrato come utilizzare KeyGesture in XAML.The following example shows how to use KeyGesture in XAML. Si noti che l'utilizzo di XAML non dichiara direttamente un <KeyGesture> elemento.Note that the XAML usage does not directly declare a <KeyGesture> element. L'utilizzo dell'elemento oggetto non è possibile perché non KeyGesture espone un costruttore pubblico senza parametri.That object element usage is not possible because KeyGesture does not expose a public parameterless constructor. Al contrario, l'utilizzo di XAML usa il comportamento TypeConverter per dichiarare un intero KeyGesture inline come Gesture valore dell'attributo.Instead, the XAML usage uses the typeconverter behavior to declare an entire KeyGesture inline as the Gesture attribute value.

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

Commenti

Nella maggior parte dei casi, un oggetto KeyGesture deve essere associato a uno o più ModifierKeys .In most cases, a KeyGesture must be associated with one or more ModifierKeys. Le eccezioni a questa regola sono i tasti funzione e i tasti tastierino numerico, che possono essere validi KeyGesture da soli.The exceptions to this rule are the function keys and the numeric keypad keys, which can be a valid KeyGesture by themselves. Ad esempio, è possibile creare un KeyGesture usando solo il tasto F12, ma per usare il tasto X in un oggetto KeyGesture deve essere abbinato a un tasto di modifica.For example, you can create a KeyGesture by using only the F12 key, but to use the X key in a KeyGesture it must be paired with a modifier key.

In generale, è possibileIn general, you can

È possibile usare un oggetto KeyBinding per associare un oggetto KeyGesture a un oggetto ICommand , in modo che il comando venga richiamato quando KeyGesture si verifica.You can use a KeyBinding to bind a KeyGesture to an ICommand, so that the command is invoked when the KeyGesture occurs.

Per KeyGesture gli utilizzi XAML, la proprietà che viene in genere impostata in XAML è Gesture , nei casi in cui il movimento rappresenta sia una chiave standard che un tasto di modifica.For KeyGesture XAML usages, the property that is generally set in XAML is Gesture, in cases where the gesture represents both a standard key and a modifier key. È anche possibile impostare la Gesture Proprietà in modo che sia solo un tasto funzione o solo una combinazione di tasti di modifica.You can also set the Gesture property to be just a function key, or just a modifier key combination. Tuttavia, è più comune impostare la Key proprietà se l'associazione di comandi prevista è un tasto funzione senza modificatori o Modifiers se l'associazione di comandi prevista è solo per i tasti di modifica.However, it is more common to set the Key property if the intended command binding is a function key with no modifiers, or Modifiers if the intended command binding is for modifier keys only.

Uso della sintassi XAML per gli attributiXAML Attribute Usage

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

Valori XAMLXAML Values

functionKey
Key

Un singolo valore di chiave, che deve essere uno dei tasti funzione (F1-12) o tastierino numerico.A single key value, which must be one of the function keys (F1-12) or numeric keypad keys.

oneOrMoreModifierKeys
Uno o più tasti di modifica, definiti dall' ModifierKeys enumerazione, delimitati da un carattere "+".One or more modifier keys, defined by the ModifierKeys enumeration, delimited with a "+" character.

key
Key

Valore di chiave singolo.A single key value.

Costruttori

KeyGesture(Key)

Inizializza una nuova istanza della classe KeyGesture con l'oggetto Key specificato.Initializes a new instance of the KeyGesture class with the specified Key.

KeyGesture(Key, ModifierKeys)

Inizializza una nuova istanza della classe KeyGesture con gli oggetti Key e ModifierKeys specificati.Initializes a new instance of the KeyGesture class with the specified Key and ModifierKeys.

KeyGesture(Key, ModifierKeys, String)

Inizializza una nuova istanza della classe KeyGesture con gli oggetti Key e ModifierKeys specificati e la stringa di visualizzazione specificata.Initializes a new instance of the KeyGesture class with the specified Key, ModifierKeys, and display string.

Proprietà

DisplayString

Ottiene una rappresentazione in forma di stringa di questo oggetto KeyGesture.Gets a string representation of this KeyGesture.

Key

Ottiene il tasto associato a questo oggetto KeyGesture.Gets the key associated with this KeyGesture.

Modifiers

Ottiene i tasti di modifica associati con questo KeyGesture.Gets the modifier keys associated with this KeyGesture.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetDisplayStringForCulture(CultureInfo)

Restituisce una stringa che può essere utilizzata per visualizzare l'oggetto KeyGesture.Returns a string that can be used to display the KeyGesture.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
Matches(Object, InputEventArgs)

Determina se l'oggetto KeyGesture corrisponde all'input associato all'oggetto InputEventArgs specificato.Determines whether this KeyGesture matches the input associated with the specified InputEventArgs object.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche