KeyGesture Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Define una combinación de teclas que se puede utilizar para invocar un comando.
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- Herencia
- Atributos
Ejemplos
En el ejemplo siguiente se muestra cómo enlazar el Close comando a mediante KeyGesture .KeyBinding
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)
En el ejemplo siguiente se muestra cómo usar KeyGesture en XAML. Tenga en cuenta que el uso de XAML no declara directamente un <KeyGesture> elemento. Ese uso de elementos de objeto no es posible porque KeyGesture no expone un constructor público sin parámetros. En su lugar, el uso de XAML usa el comportamiento de typeconverter para declarar una línea completa KeyGesture como valor de Gesture atributo.
<Window.InputBindings>
<KeyBinding Command="ApplicationCommands.Open"
Gesture="CTRL+R" />
</Window.InputBindings>
Comentarios
En la mayoría de los casos, debe KeyGesture estar asociado a uno o varios ModifierKeys. Las excepciones a esta regla son las claves de función y las claves numéricas del teclado, que pueden ser válidas KeyGesture por sí mismas. Por ejemplo, puede crear un KeyGesture mediante solo la tecla F12, pero para usar la clave X de un KeyGesture elemento debe emparejarse con una clave modificadora.
Puede usar para KeyBinding enlazar un KeyGesture objeto a , ICommandde modo que el comando se invoque cuando KeyGesture se produzca .
En KeyGesture el caso de los usos de XAML, la propiedad que se establece generalmente en XAML es Gesture, en los casos en los que el gesto representa una clave estándar y una clave modificadora. También puede establecer la Gesture propiedad para que sea solo una clave de función o simplemente una combinación de teclas modificadores. Sin embargo, es más común establecer la Key propiedad si el enlace de comandos previsto es una clave de función sin modificadores, o Modifiers si el enlace de comandos previsto es solo para las teclas modificadoras.
Uso de atributos XAML
<object property="oneOrMoreModifierKeys+key"/>
- or -
<object property="functionKey"/>
Valores XAML
functionKey
Key
Valor de clave único, que debe ser una de las teclas de función (F1-12) o claves numéricas del teclado.
oneOrMoreModifierKeys
Una o varias teclas modificadoras, definidas por la ModifierKeys enumeración, delimitadas con un carácter "+".
key
Key
Valor de clave único.
Constructores
| KeyGesture(Key) |
Inicializa una nueva instancia de la clase KeyGesture con el objeto Key especificado. |
| KeyGesture(Key, ModifierKeys) |
Inicializa una nueva instancia de la clase KeyGesture con los parámetros Key y ModifierKeys especificados. |
| KeyGesture(Key, ModifierKeys, String) |
Inicializa una nueva instancia de la clase KeyGesture con los valores de Key, ModifierKeys y la cadena de presentación especificados. |
Propiedades
| DisplayString |
Obtiene una representación en forma de cadena de este objeto KeyGesture. |
| Key |
Obtiene la tecla asociada a este objeto KeyGesture. |
| Modifiers |
Obtiene las teclas modificadoras asociadas a este objeto KeyGesture. |
Métodos
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetDisplayStringForCulture(CultureInfo) |
Devuelve una cadena que se puede utilizar para mostrar el objeto KeyGesture. |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| Matches(Object, InputEventArgs) |
Determina si este objeto KeyGesture coincide con la entrada asociada al objeto InputEventArgs especificado. |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
