InputBinding.Gesture Property

Gets or sets the InputGesture associated with this input binding.

Namespace:  System.Windows.Input
Assembly:  PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public virtual InputGesture Gesture { get; set; }
<inputBindingDerivedClass>
  <inputBindingDerivedClass.Gesture>
    <inputGestureImplementation/>
  </inputBindingDerivedClass.Gesture>
</inputBindingDerivedClass>
<KeyBinding Gesture="KeyGesture"/>- or -<MouseBinding Gesture="MouseGesture"/>- or -<inputBindingDerivedClass Gesture="InputGesture"/>

XAML Values

inputBindingDerivedClass

A derived class of InputBinding that supports object element syntax, such as KeyBinding or MouseBinding. See Remarks.

inputGestureImplementation

A custom derived class of InputGesture that supports object element syntax.

Property Value

Type: System.Windows.Input.InputGesture
The associated gesture. The default is null.

The input gesture is the action that invokes the command. Examples of input gestures in WPF are KeyGesture and MouseGesture. A KeyGesture is a combination of a Key and a set of ModifierKeys. A MouseGesture is a combination of a MouseAction and a set of ModifierKeys.

The InputBinding class itself does not support XAML usage, because it does not expose a public default constructor (there is a default constructor, but it is protected). However, derived classes can expose a public constructor and thus can set properties that are inherited from InputBinding with a XAML usage. Two existing InputBinding derived classes that can be instantiated in XAML and can set properties in XAML are KeyBinding and MouseBinding.

The following example shows how to use a KeyBinding to bind a KeyGesture to a RoutedCommand. When the KeyGesture ALT+L is pressed, the Close command is invoked.

<KeyBinding Modifiers="Alt"
            Key="L"
            Command="ApplicationCommands.Close" />
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