KeyBinding.Gesture Property

Gets or sets the gesture associated with this KeyBinding.

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

[TypeConverterAttribute(typeof(KeyGestureConverter))]
public override InputGesture Gesture { get; set; }

Property Value

Type: System.Windows.Input.InputGesture
The key sequence. The default value is null.

ExceptionCondition
ArgumentException

the value gesture is being set to is not a KeyGesture.

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

The following example shows how to bind a KeyGesture to a RoutedCommand using a KeyBinding (the markup and code examples specify different keys but are otherwise equivalent).

<Window.InputBindings>
  <KeyBinding Command="ApplicationCommands.Open"
              Gesture="CTRL+R" />
</Window.InputBindings>
KeyGesture CloseCmdKeyGesture = new KeyGesture(
    Key.L, ModifierKeys.Alt);

KeyBinding CloseKeyBinding = new KeyBinding(
    ApplicationCommands.Close, CloseCmdKeyGesture);

this.InputBindings.Add(CloseKeyBinding);

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft