KeyGesture Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit une combinaison de clavier 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 InputGesturePublic Class KeyGesture
Inherits InputGesture- Héritage
- Attributs
Exemples
L’exemple suivant montre comment lier la Close commande à une KeyGesture utilisation 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 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 de constructeur sans paramètre public. Au lieu de cela, l’utilisation XAML utilise le comportement de typeconverter pour déclarer un inline entier KeyGesture comme Gesture valeur d’attribut.
<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 eux-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é de modificateur.
Vous pouvez utiliser un KeyBinding pour lier un KeyGesture à un ICommand, afin que la commande soit appelée quand elle 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é de modificateur. Vous pouvez également définir la Gesture propriété comme une seule touche de fonction ou simplement une combinaison de touches de modification. Toutefois, il est plus courant de définir la Key propriété si la liaison de commande prévue est une clé de fonction sans modificateur, ou Modifiers si la liaison de commande prévue est destinée uniquement aux touches de modificateur.
Utilisation des 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 modificateur, définies par l’énumération ModifierKeys , délimitées par un caractère « + ».
key
Key
Valeur de clé unique.
Constructeurs
| Nom | Description |
|---|---|
| KeyGesture(Key, ModifierKeys, String) |
Initialise une nouvelle instance de la KeyGesture classe avec la chaîne d’affichage spécifiéeKeyModifierKeys. |
| KeyGesture(Key, ModifierKeys) |
Initialise une nouvelle instance de la KeyGesture classe avec les données spécifiées Key et ModifierKeys. |
| KeyGesture(Key) |
Initialise une nouvelle instance de la KeyGesture classe avec le fichier spécifié Key. |
Propriétés
| Nom | Description |
|---|---|
| DisplayString |
Obtient une représentation sous forme de chaîne de ce KeyGesture. |
| Key |
Obtient la clé associée à ce KeyGesture. |
| Modifiers |
Obtient les touches de modificateur associées à ce KeyGesture. |
Méthodes
| Nom | Description |
|---|---|
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetDisplayStringForCulture(CultureInfo) |
Retourne une chaîne qui peut être utilisée pour afficher le KeyGesture. |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| Matches(Object, InputEventArgs) |
Détermine si cela KeyGesture correspond à l’entrée associée à l’objet spécifié InputEventArgs . |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
