Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.

Traducción

Original

Este tema aún no ha recibido ninguna valoración - Valorar este tema

KeyGesture (Clase)

.NET Framework 4

Otras versiones

Define una combinación de teclas que se puede utilizar para invocar un comando.

Jerarquía de herencia

System.Object
System.Windows.Input.InputGesture
System.Windows.Input.KeyGesture

Espacio de nombres: System.Windows.Input
Ensamblado: PresentationCore (en PresentationCore.dll)
XMLNS para XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

Sintaxis

C++

[TypeConverterAttribute(typeof(KeyGestureConverter))]
public class KeyGesture : InputGesture

Uso de atributos XAML

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

Valores XAML

functionKey

Key

Valor de una sola tecla, que debe ser una de las teclas de función (F1-12) o una de las teclas del teclado numérico.

oneOrMoreModifierKeys

Una o varias teclas modificadoras, definidas por la enumeración ModifierKeys y delimitadas con un carácter "+".

key

Key

Valor de una sola tecla.

El tipo KeyGesture expone los siguientes miembros.

Constructores

	Nombre	Descripción
	KeyGesture(Key)	Inicializa una nueva instancia de la clase KeyGesture con el valor de Key especificado.
	KeyGesture(Key, ModifierKeys)	Inicializa una nueva instancia de la clase KeyGesture con los valores de Key y ModifierKeys que se hayan especificado.
	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.

Arriba

Propiedades

	Nombre	Descripción
	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.

Arriba

Métodos

	Nombre	Descripción
	Equals(Object)	Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
	Finalize	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
	GetDisplayStringForCulture	Devuelve una cadena que se puede utilizar para mostrar el objeto KeyGesture.
	GetHashCode	Actúa como función hash para un tipo concreto. (Se hereda de Object).
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	Matches	Determina si este objeto KeyGesture coincide con la entrada asociada al objeto InputEventArgs especificado. (Invalida a InputGesture.Matches(Object, InputEventArgs)).
	MemberwiseClone	Crea una copia superficial del Object actual. (Se hereda de Object).
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).

Arriba

Comentarios

En la mayoría de los casos, KeyGesture debe asociarse a una o varias teclas ModifierKeys. Las excepciones a esta regla son las teclas de función y las del teclado numérico, que pueden constituir un objeto KeyGesture válido por sí mismas. Por ejemplo, puede crear un objeto KeyGesture utilizando sólo la tecla F12, pero para utilizar la tecla X en KeyGesture es preciso combinarla con una tecla modificadora.

En general, puede

utilizar KeyBinding para enlazar KeyGesture a ICommand, de modo que se invoque el comando cuando se produzca KeyGesture.

Para el uso de KeyGesture en XAML, la propiedad que generalmente se establece en XAML es Gesture cuando el movimiento representa una tecla estándar y una tecla modificadora. También puede establecer la propiedad Gesture para que sea simplemente una tecla de función o una combinación de teclas modificadoras. Sin embargo, se suele establecer la propiedad Key si el enlace de comandos es una tecla de función sin modificadores, o bien, Modifiers si el enlace de comandos sólo es para teclas modificadoras.

Ejemplos

En el ejemplo siguiente se muestra cómo enlazar el comando Close a KeyGesture utilizando KeyBinding.


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

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

this.InputBindings.Add(CloseKeyBinding);

En el siguiente ejemplo se muestra cómo utilizar KeyGesture en XAML. Observe que el uso de XAML no declara directamente un elemento <KeyGesture>. El uso de ese elemento de objeto no es posible porque KeyGesture no expone un constructor predeterminado público. En XAML se utiliza el comportamiento del convertidor de tipos para declarar todo un KeyGesture insertado como el valor de atributo Gesture.

XAML


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

Información de versión

.NET Framework

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Plataformas

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Vea también