Partage via


KeyGesture Classe

Définition

Définit une combinaison de touches qui peut être utilisée pour appeler une commande.

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
Héritage
KeyGesture
Attributs

Exemples

L’exemple suivant montre comment lier la Close commande à un KeyGesture à l’aide d’un 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’exemple suivant montre comment utiliser KeyGesture en XAML. Notez que l’utilisation de XAML ne déclare pas directement un <KeyGesture> élément. L’utilisation de cet élément d’objet n’est pas possible, car KeyGesture elle n’expose pas un constructeur public sans paramètre. Au lieu de cela, l’utilisation xaml utilise le comportement typeconverter pour déclarer une valeur d’attribut inline Gesture entièreKeyGesture.

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

Remarques

Dans la plupart des cas, un KeyGesture doit être associé à un ou plusieurs ModifierKeys. Les exceptions à cette règle sont les touches de fonction et les touches de pavé numérique, qui peuvent être valides KeyGesture par elles-mêmes. Par exemple, vous pouvez créer un KeyGesture en utilisant uniquement la touche F12, mais pour utiliser la touche X dans un KeyGesture , il doit être associé à une clé modificateur.

Vous pouvez utiliser un KeyBinding pour lier un KeyGesture à un ICommand, afin que la commande soit appelée lorsque le KeyGesture se produit.

Pour KeyGesture les utilisations XAML, la propriété généralement définie en XAML est Gesture, dans les cas où le mouvement représente à la fois une clé standard et une clé modificateur. Vous pouvez également définir la Gesture propriété comme étant simplement une clé de fonction ou simplement une combinaison de touches modificateurs. Toutefois, il est plus courant de définir la propriété si la Key liaison de commande prévue est une clé de fonction sans modificateurs, ou Modifiers si la liaison de commande prévue concerne uniquement les clés de modification.

Utilisation d'attributs XAML

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

Valeurs XAML

functionKey
Key

Valeur de clé unique, qui doit être l’une des touches de fonction (F1-12) ou des touches de pavé numérique.

oneOrMoreModifierKeys
Une ou plusieurs touches de modification, définies par l’énumération ModifierKeys , délimitées par un caractère « + ».

key
Key

Valeur de clé unique.

Constructeurs

KeyGesture(Key)

Initialise une nouvelle instance de la classe KeyGesture avec le Key spécifié.

KeyGesture(Key, ModifierKeys)

Initialise une nouvelle instance de la classe KeyGesture avec les Key et ModifierKeys spécifiés.

KeyGesture(Key, ModifierKeys, String)

Initialise une nouvelle instance de la classe KeyGesture, avec les Key, ModifierKeys et la chaîne d'affichage spécifiés.

Propriétés

DisplayString

Obtient une représentation sous forme de chaîne de ce KeyGesture.

Key

Obtient la touche associée à ce KeyGesture.

Modifiers

Obtient les touches de modification associées à ce KeyGesture.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetDisplayStringForCulture(CultureInfo)

Renvoie une chaîne qui peut être utilisée pour afficher le KeyGesture.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
Matches(Object, InputEventArgs)

Détermine si ce KeyGesture correspond à l'entrée associée à l'objet InputEventArgs spécifié.

MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi