Edit

Share via


KeyBinding.Modifiers Property

Definition

Gets or sets the ModifierKeys of the KeyGesture associated with this KeyBinding.

public:
 property System::Windows::Input::ModifierKeys Modifiers { System::Windows::Input::ModifierKeys get(); void set(System::Windows::Input::ModifierKeys value); };
public System.Windows.Input.ModifierKeys Modifiers { get; set; }
member this.Modifiers : System.Windows.Input.ModifierKeys with get, set
Public Property Modifiers As ModifierKeys

Property Value

The modifier keys of the KeyGesture. The default value is None.

Remarks

With the exception of the function keys and the numeric keypad keys, a KeyGesture must contain a Key and one or more ModifierKeys.

When defining a KeyBinding in Extensible Application Markup Language (XAML) there are two ways to specify the KeyGesture. The first way to establish a KeyBinding in XAML is to define the Gesture attribute of the KeyBinding element, which enables a syntax to specify keys and modifiers as a single string, for example "CTRL+P". The second way is to define the Key attribute and the Modifiers attributes of the KeyBinding element. Both ways of setting the KeyGesture are equivalent and modify the same underlying object, but there will be a conflict if both are used. In the case when the Key, Modifiers, and the Gesture attributes are all set, the attribute which is defined last will be used for the KeyGesture. You can potentially have situations where for example a Key set last will overwrite just the Key component of a preceding Gesture but leave the Gesture's modifiers the same. In general, it is recommended that you use only the Gesture attribute from XAML; this will avoid ambiguity, provides the most streamlined syntax, and provides the most straightforward representation for serialization.

XAML Attribute Usage

<object Modifiers="oneOrMoreModifierKeys"/>  

XAML Values

oneOrMoreModifierKeys
One or more modifier keys, defined by the ModifierKeys enumeration, delimited with a "+" character.

Applies to

See also