KeyGesture Classe

Définition

Définit une combinaison de touches qui peut être utilisée pour appeler une commande.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
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 KeyBindingd’un.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)

L’exemple suivant montre comment utiliser KeyGesture dans. XAMLXAMLThe following example shows how to use KeyGesture in XAMLXAML. Notez que l' XAMLXAML utilisation ne déclare pas directement un <KeyGesture> élément.Note that the XAMLXAML usage does not directly declare a <KeyGesture> element. Cette utilisation d’élément objet n’est pas KeyGesture possible, car n’expose pas de constructeur sans paramètre public.That object element usage is not possible because KeyGesture does not expose a public parameterless constructor. Au lieu de XAMLXAML cela, l’utilisation utilise le comportement TypeConverter pour KeyGesture déclarer une inline Gesture entière comme valeur d’attribut.Instead, the XAMLXAML 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>

Remarques

Dans la plupart des cas KeyGesture , un doit être associé à un ModifierKeysou plusieurs.In most cases, a KeyGesture must be associated with one or more ModifierKeys. Les exceptions à cette règle sont les touches de fonction et les touches de pavé numérique, qui peuvent être KeyGesture une valide par elles-mêmes.The exceptions to this rule are the function keys and the numeric keypad keys, which can be a valid KeyGesture by themselves. 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 touche de modification.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.

En général, vous pouvezIn general, you can

Vous pouvez utiliser un KeyBinding pour lier un KeyGesture à un ICommand, afin KeyGesture que la commande soit appelée lorsque se produit.You can use a KeyBinding to bind a KeyGesture to an ICommand, so that the command is invoked when the KeyGesture occurs.

Pour KeyGesture XAMLXAML Gestureles utilisations, la propriété qui est généralement définie dans est, dans les cas où le mouvement représente à la fois une clé standard et une touche de modification. XAMLXAMLFor KeyGesture XAMLXAML usages, the property that is generally set in XAMLXAML is Gesture, in cases where the gesture represents both a standard key and a modifier key. Vous pouvez également définir la Gesture propriété pour qu’elle soit simplement une touche de fonction, ou simplement une combinaison de touches de modification.You can also set the Gesture property to be just a function key, or just a modifier key combination. Toutefois, il est plus courant de définir la Key propriété si la liaison de commande prévue est une touche de fonction sans modificateurs, Modifiers ou si la liaison de commande prévue est uniquement pour les touches de modification.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.

Utilisation d'attributs XAMLXAML Attribute Usage

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

Valeurs XAMLXAML Values

functionKey
Key

Une valeur de clé unique, qui doit être l’une des touches de fonction (F1-12) ou des touches de pavé numérique.A single key value, which must be one of the function keys (F1-12) or numeric keypad keys.

oneOrMoreModifierKeys
Une ou plusieurs touches de modification, définies par l' ModifierKeys énumération, délimitées par un caractère «+».One or more modifier keys, defined by the ModifierKeys enumeration, delimited with a "+" character.

key
Key

Valeur de clé unique.A single key value.

Constructeurs

KeyGesture(Key)

Initialise une nouvelle instance de la classe KeyGesture avec le Key spécifié.Initializes a new instance of the KeyGesture class with the specified Key.

KeyGesture(Key, ModifierKeys)

Initialise une nouvelle instance de la classe KeyGesture avec les Key et ModifierKeys spécifiés.Initializes a new instance of the KeyGesture class with the specified Key and ModifierKeys.

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.Initializes a new instance of the KeyGesture class with the specified Key, ModifierKeys, and display string.

Propriétés

DisplayString

Obtient une représentation sous forme de chaîne de ce KeyGesture.Gets a string representation of this KeyGesture.

Key

Obtient la touche associée à ce KeyGesture.Gets the key associated with this KeyGesture.

Modifiers

Obtient les touches de modification associées à ce KeyGesture.Gets the modifier keys associated with this KeyGesture.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

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

Renvoie une chaîne qui peut être utilisée pour afficher le KeyGesture.Returns a string that can be used to display the KeyGesture.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

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

Détermine si ce KeyGesture correspond à l'entrée associée à l'objet InputEventArgs spécifié.Determines whether this KeyGesture matches the input associated with the specified InputEventArgs object.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi