ModifierKeys Enumeration

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Specifies the set of modifier keys.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace:  System.Windows.Input
Assembly:  System.Windows (in System.Windows.dll)

Syntax

<FlagsAttribute> _
Public Enumeration ModifierKeys
[FlagsAttribute]
public enum ModifierKeys

Members

Member name Description
None No modifiers are pressed.
Alt The ALT key is pressed.
Control The CTRL key is pressed.
Shift The SHIFT key is pressed.
Windows The Windows logo key is pressed.
Apple The Apple key (also known as the Open Apple key) is pressed.

Remarks

Windows Phone is a cross-platform technology. Certain values of this enumeration will only logically originate from certain operating systems.

This is a flags enumeration. If multiple modifier keys are pressed, bitwise comparisons against the value will return true, and you can also directly check for equalities of key combinations in operations by adding the values, for instance to check if CTRL+ALT is pressed.

ModifierKeys does not typically have a XAML usage. ModifierKeys is generally only used for code, and bitwise comparisons of values from Keyboard..::.Modifiers that are checked from a key-related or command-related event handler. If keys that are traditionally modifiers need to be specified in XAML, you should use Key.

The enumeration constants Apple and Windows are deliberately assigned to the same underlying value. Because of the platform dependencies, the two enumeration values will never coincide, and also because of the platform characteristics the two values have somewhat equivalent meanings. Your handler can choose to take advantage of this implementation detail by checking for either Apple or Windows. If you use the recommended technique of bitwise comparison, this is already the behavior.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

System.Windows.Input Namespace

Key

KeyEventArgs

Keyboard..::.Modifiers