Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

KeyBinding classe

 

Date de publication : novembre 2016

Lie un KeyGesture à un RoutedCommand (ou un autre ICommand implémentation).

Espace de noms:   System.Windows.Input
Assembly:  PresentationCore (dans PresentationCore.dll)

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Freezable
        System.Windows.Input.InputBinding
          System.Windows.Input.KeyBinding

public class KeyBinding : InputBinding

NomDescription
System_CAPS_pubmethodKeyBinding()

Initialise une nouvelle instance de la classe KeyBinding.

System_CAPS_pubmethodKeyBinding(ICommand, Key, ModifierKeys)

Initialise une nouvelle instance de la KeyBinding classe à l’aide de la ICommand et le Key et ModifierKeys qui sera converti en un KeyGesture.

System_CAPS_pubmethodKeyBinding(ICommand, KeyGesture)

Initialise une nouvelle instance de la KeyBinding classe à l’aide de la ICommand et KeyGesture.

NomDescription
System_CAPS_pubpropertyCanFreeze

Obtient une valeur qui indique si l’objet peut être rendu non modifiable.(Hérité de Freezable.)

System_CAPS_pubpropertyCommand

Obtient ou définit le ICommand associé à cette liaison d'entrée.(Hérité de InputBinding.)

System_CAPS_pubpropertyCommandParameter

Obtient ou définit les données spécifiques à la commande pour une commande particulière.(Hérité de InputBinding.)

System_CAPS_pubpropertyCommandTarget

Obtient ou définit l’élément cible de la commande.(Hérité de InputBinding.)

System_CAPS_pubpropertyDependencyObjectType

Obtient les DependencyObjectType qui encapsule le CLR type de cette instance. (Hérité de DependencyObject.)

System_CAPS_pubpropertyDispatcher

Obtient le Dispatcher cela DispatcherObject est associé.(Hérité de DispatcherObject.)

System_CAPS_pubpropertyGesture

Obtient ou définit le mouvement associé à ce KeyBinding.(Remplace InputBinding.Gesture.)

System_CAPS_pubpropertyIsFrozen

Obtient une valeur qui indique si l’objet est actuellement modifiable.(Hérité de Freezable.)

System_CAPS_pubpropertyIsSealed

Obtient une valeur qui indique si cette instance est actuellement sealed (en lecture seule).(Hérité de DependencyObject.)

System_CAPS_pubpropertyKey

Obtient ou définit le Key de la KeyGesture associé à ce KeyBinding.

System_CAPS_pubpropertyModifiers

Obtient ou définit le ModifierKeys de la KeyGesture associé à ce KeyBinding.

NomDescription
System_CAPS_pubmethodCheckAccess()

Détermine si le thread appelant a accès à ce DispatcherObject.(Hérité de DispatcherObject.)

System_CAPS_pubmethodClearValue(DependencyProperty)

Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty.(Hérité de DependencyObject.)

System_CAPS_pubmethodClearValue(DependencyPropertyKey)

Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par DependencyPropertyKey.(Hérité de DependencyObject.)

System_CAPS_pubmethodClone()

Crée un clone modifiable de Freezable, en créant des copies complètes des valeurs de l’objet. Lors de la copie des propriétés de dépendance de l’objet, cette méthode copie les expressions (qui peuvent ne plus se résoudre), mais pas les animations ni leurs valeurs actuelles.(Hérité de Freezable.)

System_CAPS_protmethodCloneCore(Freezable)

Copie les valeurs de base (non animées) des propriétés de l’objet spécifié.(Hérité de InputBinding.)

System_CAPS_pubmethodCloneCurrentValue()

Crée un clone modifiable (copie intégrale) de le Freezable à l’aide de ses valeurs actuelles.(Hérité de Freezable.)

System_CAPS_protmethodCloneCurrentValueCore(Freezable)

Copie les valeurs actuelles des propriétés de l’objet spécifié.(Hérité de InputBinding.)

System_CAPS_pubmethodCoerceValue(DependencyProperty)

Convertit la valeur de la propriété de dépendance spécifiée. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant.(Hérité de DependencyObject.)

System_CAPS_protmethodCreateInstance()

Initialise une nouvelle instance de la classe Freezable.(Hérité de Freezable.)

System_CAPS_protmethodCreateInstanceCore()

Crée une instance d’un KeyBinding.(Remplace InputBinding.CreateInstanceCore().)

System_CAPS_pubmethodEquals(Object)

Détermine si un DependencyObject est équivalente à l’actuel DependencyObject.(Hérité de DependencyObject.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodFreeze()

Rend l’objet actif non modifiable et attribue à sa propriété IsFrozen la valeur true.(Hérité de Freezable.)

System_CAPS_protmethodFreezeCore(Boolean)

Rend le Freezable d’objet non modifiable ou vérifie si elle peut être rendue non modifiable.(Hérité de Freezable.)

System_CAPS_pubmethodGetAsFrozen()

Crée une copie figée de le Freezable, à l’aide des valeurs de propriétés (non animées) de base. Étant donné que la copie est figée, les sous-objets figés sont copiées par référence.(Hérité de Freezable.)

System_CAPS_protmethodGetAsFrozenCore(Freezable)

Convertit l’instance en clone figé spécifié Freezable à l’aide des valeurs de propriétés (non animées) de base.(Hérité de InputBinding.)

System_CAPS_pubmethodGetCurrentValueAsFrozen()

Crée une copie figée de le Freezable à l’aide des valeurs de propriété actuelles. Étant donné que la copie est figée, les sous-objets figés sont copiées par référence.(Hérité de Freezable.)

System_CAPS_protmethodGetCurrentValueAsFrozenCore(Freezable)

Convertit l’instance actuelle en un clone figé du Freezable spécifié. Si l’objet a des propriétés de dépendance animées, leurs valeurs animées actuelles sont copiées.(Hérité de InputBinding.)

System_CAPS_pubmethodGetHashCode()

Obtient un code de hachage pour ce DependencyObject.(Hérité de DependencyObject.)

System_CAPS_pubmethodGetLocalValueEnumerator()

Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject.(Hérité de DependencyObject.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodGetValue(DependencyProperty)

Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject.(Hérité de DependencyObject.)

System_CAPS_pubmethodInvalidateProperty(DependencyProperty)

Réévalue la valeur effective de la propriété de dépendance spécifiée(Hérité de DependencyObject.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodOnChanged()

Appelée lorsque l’actuel Freezable objet est modifié.(Hérité de Freezable.)

System_CAPS_protmethodOnFreezablePropertyChanged(DependencyObject, DependencyObject)

Garantit que les pointeurs de contexte appropriés sont établis pour un DependencyObjectType membre de données qui a simplement été définie.(Hérité de Freezable.)

System_CAPS_protmethodOnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF) et n’est pas destiné à être directement utilisé à partir de votre code.(Hérité de Freezable.)

System_CAPS_protmethodOnPropertyChanged(DependencyPropertyChangedEventArgs)

Substitue l’implémentation DependencyObject de OnPropertyChanged pour appeler également tous les gestionnaires Changed en réponse à une propriété de dépendance variable de type Freezable.(Hérité de Freezable.)

System_CAPS_pubmethodReadLocalValue(DependencyProperty)

Retourne la valeur locale d’une propriété de dépendance, si elle existe.(Hérité de DependencyObject.)

System_CAPS_protmethodReadPreamble()

Garantit que le Freezable à partir d’un thread valide. Les héritiers de Freezable doit appeler cette méthode au début de n’importe quel API qui lit les données membres qui ne sont pas des propriétés de dépendance.(Hérité de Freezable.)

System_CAPS_pubmethodSetCurrentValue(DependencyProperty, Object)

Définit la valeur d’une propriété de dépendance sans modifier sa valeur source.(Hérité de DependencyObject.)

System_CAPS_pubmethodSetValue(DependencyProperty, Object)

Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance.(Hérité de DependencyObject.)

System_CAPS_pubmethodSetValue(DependencyPropertyKey, Object)

Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance.(Hérité de DependencyObject.)

System_CAPS_protmethodShouldSerializeProperty(DependencyProperty)

Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie.(Hérité de DependencyObject.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodVerifyAccess()

Impose que le thread appelant a accès à ce DispatcherObject.(Hérité de DispatcherObject.)

System_CAPS_protmethodWritePostscript()

Déclenche l’événement Changed pour le Freezable et appelle sa méthode OnChanged. Les classes qui dérivent de Freezable doivent appeler cette méthode à la fin de toute API qui modifie des membres de classe qui ne sont pas stockés en tant que propriétés de dépendance.(Hérité de Freezable.)

System_CAPS_protmethodWritePreamble()

Vérifie que le Freezable n’est pas figé et accessible à partir d’un contexte de thread valid. Freezable les héritiers doivent appeler cette méthode au début de n’importe quel API qui écrit des membres de données qui ne sont pas des propriétés de dépendance.(Hérité de Freezable.)

NomDescription
System_CAPS_pubfieldSystem_CAPS_staticKeyProperty

Identifie la propriété de dépendance Key.

System_CAPS_pubfieldSystem_CAPS_staticModifiersProperty

Identifie la propriété de dépendance Modifiers.

NomDescription
System_CAPS_pubeventChanged

Se produit lorsque le Freezable ou un objet qu’il contient est modifié.(Hérité de Freezable.)

Un KeyBinding associe un KeyGesture avec un ICommand, comme un RoutedCommand. RoutedCommand est l’implémentation principale de le ICommand de l’interface pour la WPF commandes système.  En général, lorsque le KeyGesture est exécutée la commande est appelée, bien que le comportement de commande plus dépend des facteurs propres aux commandes tels que la CanExecute valeur. Pour plus d’informations sur l’exécution des commandes, consultez le vue d’ensemble des commandes.

À l’exception des touches de fonction et les touches du pavé numérique, valides KeyGesture doit contenir exactement un Key et un ou plusieurs ModifierKeys. Touches de fonction et les touches du pavé numérique ne requièrent pas une touche de modification afin d’être valide KeyGesture. Il est possible de spécifier un non valide KeyGesture et un KeyBinding non valide associée geste, que ce soit via XAML ou du code. Par exemple, il n’existe aucune validation n’empêche la création et la liaison un KeyGesture qui contient uniquement une clé trouvé, ou uniquement des modificateurs mais aucune clé. Tel un KeyBinding ne tentera jamais d’appeler la commande associée.

Lorsque vous définissez un KeyBinding dans langage XAML (eXtensible Application Markup Language) il existe deux façons de spécifier le KeyGesture. La première méthode pour établir une KeyBinding dans XAML consiste à définir le Gesture attribut de la KeyBinding élément, ce qui permet à une syntaxe de spécifier des clés et des modificateurs comme une chaîne unique, par exemple « CTRL + P ». La deuxième méthode consiste à définir le Key attribut et Modifiers les attributs de la KeyBinding élément. Les deux méthodes de définition du KeyGesture sont équivalentes et modifient le même objet sous-jacent, mais il y a un conflit si les deux sont utilisés. Dans le cas lorsque le Key, Modifiers, et le Gesture attributs sont définis, l’attribut défini dernier sera utilisé pour le KeyGesture. Il peut exister des situations où, par exemple un Key ensemble dernier remplace le composant clé d’un mouvement précédent mais que les modificateurs du mouvement identiques. En général, il est recommandé d’utiliser uniquement le Gesture de l’attribut XAML; Cela évite toute ambiguïté, fournit la syntaxe la plus simplifiée et la représentation la plus simple pour la sérialisation.

Un KeyBinding peut être défini sur un objet spécifique ou au niveau de la classe en enregistrant un RegisterClassInputBinding sur la CommandManager classe. La méthode plus classique pour définir un KeyBinding se trouve dans le modèle de contrôle, en définissant le InputBindings propriété dans XAML en déclarant un ou plusieurs MouseBinding ou KeyBinding éléments.

L’exemple suivant crée un KeyBinding et l’ajoute à la InputBindingCollection de la fenêtre racine.

<Window.InputBindings>
  <KeyBinding Command="ApplicationCommands.Open"
              Gesture="CTRL+R" />
</Window.InputBindings>
// Creating a KeyBinding between the Open command and Ctrl-R
KeyBinding OpenCmdKeyBinding = new KeyBinding(
    ApplicationCommands.Open, 
    Key.R, 
    ModifierKeys.Control);

this.InputBindings.Add(OpenCmdKeyBinding);

.NET Framework
Disponible depuis 3.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: