KeyGesture 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
定义可用来调用命令的组合键。
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 InputGesturePublic Class KeyGesture
Inherits InputGesture- 继承
- 属性
示例
以下示例演示如何使用 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) |
