InputBinding.Gesture Property

 

Gets or sets the InputGesture associated with this input binding.

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

public virtual InputGesture Gesture {
	get;
	[SecurityCriticalAttribute]
	set;
}

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.

<KeyBinding Gesture="KeyGesture"/>

- or -

<MouseBinding Gesture="MouseGesture"/>

- or -

<inputBindingDerivedClass Gesture="InputGesture"/>

<inputBindingDerivedClass>
  <inputBindingDerivedClass.Gesture>
    <inputGestureImplementation/>
  </inputBindingDerivedClass.Gesture>
</inputBindingDerivedClass>

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.

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
Available since 3.0
Return to top
Show: