KeyGesture Clase

  • Referencia

Definición

Espacio de nombres:
System.Windows.Input
Ensamblado:
PresentationCore.dll

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 InputGesture
Public Class KeyGesture
Inherits InputGesture
Herencia
Object
InputGesture
KeyGesture
Atributos
TypeConverterAttribute

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)

Se aplica a

Consulte también