KeyGesture 类

  • 参考

定义

命名空间:
System.Windows.Input
程序集:
PresentationCore.dll

定义可用来调用命令的组合键。

public ref class KeyGesture : System::Windows::Input::InputGesture
[System.ComponentModel.TypeConverter(typeof(System.Windows.Input.KeyGestureConverter))]
public class KeyGesture : System.Windows.Input.InputGesture
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Input.KeyGestureConverter))>]
type KeyGesture = class
    inherit InputGesture
Public Class KeyGesture
Inherits InputGesture
继承
Object
InputGesture
KeyGesture
属性
TypeConverterAttribute

示例

以下示例演示如何使用 KeyBinding将命令KeyGesture绑定到 Close 。

KeyGesture CloseCmdKeyGesture = new KeyGesture(
    Key.L, ModifierKeys.Alt);

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

this.InputBindings.Add(CloseKeyBinding);

Dim CloseCmdKeyGesture As New KeyGesture(Key.L, ModifierKeys.Alt)

Dim CloseKeyBinding As New KeyBinding(ApplicationCommands.Close, CloseCmdKeyGesture)

Me.InputBindings.Add(CloseKeyBinding)

以下示例演示如何 KeyGesture 在 XAML 中使用。 请注意，XAML 用法不会直接声明 <KeyGesture> 元素。 无法使用该对象元素，因为 KeyGesture 不公开公共无参数构造函数。 相反，XAML 用法使用 typeconverter 行为将整个 KeyGesture 内联声明为 Gesture 属性值。

<Window.InputBindings>
  <KeyBinding Command="ApplicationCommands.Open"
              Gesture="CTRL+R" />
</Window.InputBindings>

注解

在大多数情况下， KeyGesture 必须与一个或多个 ModifierKeys相关联。 此规则的例外是功能键和数字键盘键，它们本身可能有效 KeyGesture 。 例如，可以仅使用 F12 键创建 KeyGesture ，但若要在 中使用 KeyGesture X 键，则必须将其与修饰键配对。

可以使用 KeyBinding 将 绑定到 KeyGesture ， ICommand以便在 发生 时 KeyGesture 调用命令。

对于 KeyGesture XAML 用法，在手势同时表示标准键和修饰键的情况下，通常在 XAML Gesture中设置的属性为 。 还可以将 Gesture 属性设置为只是一个函数键，或者只是一个修饰键组合。 但是，如果预期的命令绑定是没有修饰符的函数键，或者Modifiers如果预期的命令绑定仅用于修饰键，则更常见的情况是设置 Key 属性。

XAML 属性用法

<object property="oneOrMoreModifierKeys+key"/>  
- or -  
<object property="functionKey"/>

XAML 值

functionKey
Key

单个键值，该值必须是 F1-12) 或数字键盘键 (功能键之一。

oneOrMoreModifierKeys
一个或多个修饰键，由 ModifierKeys 枚举定义，用“+”字符分隔。

key
Key

单个键值。

构造函数

KeyGesture(Key)

使用指定的 KeyGesture 初始化 Key 类的新实例。
KeyGesture(Key, ModifierKeys)

使用指定的 KeyGesture 和 Key 初始化 ModifierKeys 类的新实例。
KeyGesture(Key, ModifierKeys, String)

使用指定的 KeyGesture、Key 和显示字符串初始化 ModifierKeys 类的新实例。

属性

DisplayString

获取此 KeyGesture 的字符串表示形式。
Key

获取与此 KeyGesture 关联的键。
Modifiers

获取与此 KeyGesture 关联的修改键。

方法

Equals(Object)

确定指定对象是否等于当前对象。

(继承自 Object)
GetDisplayStringForCulture(CultureInfo)

返回可用于显示 KeyGesture 的字符串。
GetHashCode()

作为默认哈希函数。

(继承自 Object)
GetType()

获取当前实例的 Type。

(继承自 Object)
Matches(Object, InputEventArgs)

确定此 KeyGesture 是否和与指定的 InputEventArgs 对象关联的输入匹配。
MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
ToString()

返回表示当前对象的字符串。

(继承自 Object)

适用于

另请参阅