KeyGesture KeyGesture KeyGesture KeyGesture Class

Definición

Define una combinación de teclas que se puede utilizar para invocar un comando.Defines a keyboard combination that can be used to invoke a command.

public ref class KeyGesture : System::Windows::Input::InputGesture
[System.ComponentModel.TypeConverter(typeof(System.Windows.Input.KeyGestureConverter))]
public class KeyGesture : System.Windows.Input.InputGesture
type KeyGesture = class
    inherit InputGesture
Public Class KeyGesture
Inherits InputGesture
Herencia
Atributos

Ejemplos

En el ejemplo siguiente se muestra cómo enlazar el Close comando a un KeyBinding KeyGesture mediante.The following example shows how to bind the Close command to a KeyGesture using a 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 KeyGesture usar XAMLXAMLen.The following example shows how to use KeyGesture in XAMLXAML. Tenga en cuenta XAMLXAML que el uso no declara directamente <KeyGesture> un elemento.Note that the XAMLXAML usage does not directly declare a <KeyGesture> element. El uso de elementos de objeto no es KeyGesture posible porque no expone un constructor sin parámetros público.That object element usage is not possible because KeyGesture does not expose a public parameterless constructor. En su lugar, XAMLXAML el uso usa el comportamiento de TypeConverter para declarar KeyGesture todo en línea como Gesture valor de atributo.Instead, the XAMLXAML usage uses the typeconverter behavior to declare an entire KeyGesture inline as the Gesture attribute value.

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

Comentarios

En la mayoría de los KeyGesture casos, se debe asociar a ModifierKeysuno o varios.In most cases, a KeyGesture must be associated with one or more ModifierKeys. Las excepciones a esta regla son las teclas de función y las teclas del teclado numérico, que pueden ser KeyGesture válidas por sí mismas.The exceptions to this rule are the function keys and the numeric keypad keys, which can be a valid KeyGesture by themselves. Por ejemplo, puede crear un KeyGesture con solo la tecla F12, pero para usar la tecla X KeyGesture en, se debe emparejar con una tecla modificadora.For example, you can create a KeyGesture by using only the F12 key, but to use the X key in a KeyGesture it must be paired with a modifier key.

En general, puedeIn general, you can

Puede utilizar un KeyBinding para enlazar un KeyGesture a un ICommand, de modo KeyGesture que se invoque el comando cuando se produce.You can use a KeyBinding to bind a KeyGesture to an ICommand, so that the command is invoked when the KeyGesture occurs.

En KeyGesture el caso de XAMLXAML los usos, la propiedad que se XAMLXAML establece Gesturenormalmente en es, en los casos en que el gesto representa una clave estándar y una tecla modificadora.For KeyGesture XAMLXAML usages, the property that is generally set in XAMLXAML is Gesture, in cases where the gesture represents both a standard key and a modifier key. También puede establecer la Gesture propiedad para que sea simplemente una tecla de función o simplemente una combinación de teclas modificadora.You can also set the Gesture property to be just a function key, or just a modifier key combination. Sin embargo, es más común establecer la Key propiedad si el enlace de comandos previsto es una tecla de función sin modificadores o Modifiers si el enlace de comandos previsto es solo para las teclas modificadoras.However, it is more common to set the Key property if the intended command binding is a function key with no modifiers, or Modifiers if the intended command binding is for modifier keys only.

Uso de atributos XAMLXAML Attribute Usage

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

Valores XAMLXAML Values

functionKey
Key

Un valor de clave único, que debe ser una de las teclas de función (F1-12) o teclas del teclado numérico.A single key value, which must be one of the function keys (F1-12) or numeric keypad keys.

oneOrMoreModifierKeys
Una o más teclas modificadoras, definidas por la ModifierKeys enumeración, delimitadas con un carácter "+".One or more modifier keys, defined by the ModifierKeys enumeration, delimited with a "+" character.

key
Key

Un valor de clave único.A single key value.

Constructores

KeyGesture(Key) KeyGesture(Key) KeyGesture(Key) KeyGesture(Key)

Inicializa una nueva instancia de la clase KeyGesture con el objeto Key especificado.Initializes a new instance of the KeyGesture class with the specified Key.

KeyGesture(Key, ModifierKeys) KeyGesture(Key, ModifierKeys) KeyGesture(Key, ModifierKeys) KeyGesture(Key, ModifierKeys)

Inicializa una nueva instancia de la clase KeyGesture con los parámetros Key y ModifierKeys especificados.Initializes a new instance of the KeyGesture class with the specified Key and ModifierKeys.

KeyGesture(Key, ModifierKeys, String) KeyGesture(Key, ModifierKeys, String) KeyGesture(Key, ModifierKeys, String) 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.Initializes a new instance of the KeyGesture class with the specified Key, ModifierKeys, and display string.

Propiedades

DisplayString DisplayString DisplayString DisplayString

Obtiene una representación en forma de cadena de este objeto KeyGesture.Gets a string representation of this KeyGesture.

Key Key Key Key

Obtiene la tecla asociada a este objeto KeyGesture.Gets the key associated with this KeyGesture.

Modifiers Modifiers Modifiers Modifiers

Obtiene las teclas modificadoras asociadas a este objeto KeyGesture.Gets the modifier keys associated with this KeyGesture.

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetDisplayStringForCulture(CultureInfo) GetDisplayStringForCulture(CultureInfo) GetDisplayStringForCulture(CultureInfo) GetDisplayStringForCulture(CultureInfo)

Devuelve una cadena que se puede utilizar para mostrar el objeto KeyGesture.Returns a string that can be used to display the KeyGesture.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
Matches(Object, InputEventArgs) Matches(Object, InputEventArgs) Matches(Object, InputEventArgs) Matches(Object, InputEventArgs)

Determina si este objeto KeyGesture coincide con la entrada asociada al objeto InputEventArgs especificado.Determines whether this KeyGesture matches the input associated with the specified InputEventArgs object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a

Consulte también: