MouseBinding Clase

Definición

Espacio de nombres:

System.Windows.Input

Ensamblado:

PresentationCore.dll

Enlaza un MouseGesture objeto a una RoutedCommand (u otra ICommand implementación).

public ref class MouseBinding : System::Windows::Input::InputBinding

public class MouseBinding : System.Windows.Input.InputBinding

type MouseBinding = class
    inherit InputBinding

Public Class MouseBinding
Inherits InputBinding

Herencia

Object

DispatcherObject

DependencyObject

Freezable

InputBinding

MouseBinding

Ejemplos

En el ejemplo siguiente se muestra cómo usar un MouseBinding para enlazar un MouseGesture objeto a .RoutedCommand

<MouseBinding Gesture="Control+WheelClick"
              Command="ApplicationCommands.Open" />

MouseGesture OpenCmdMouseGesture = new MouseGesture();
OpenCmdMouseGesture.MouseAction = MouseAction.WheelClick;
OpenCmdMouseGesture.Modifiers = ModifierKeys.Control;

MouseBinding OpenCmdMouseBinding = new MouseBinding();
OpenCmdMouseBinding.Gesture = OpenCmdMouseGesture;
OpenCmdMouseBinding.Command = ApplicationCommands.Open;

this.InputBindings.Add(OpenCmdMouseBinding);

Dim OpenCmdMouseGesture As New MouseGesture()
OpenCmdMouseGesture.MouseAction = MouseAction.WheelClick
OpenCmdMouseGesture.Modifiers = ModifierKeys.Control

Dim OpenCmdMouseBinding As New MouseBinding()
OpenCmdMouseBinding.Gesture = OpenCmdMouseGesture
OpenCmdMouseBinding.Command = ApplicationCommands.Open

Me.InputBindings.Add(OpenCmdMouseBinding)

Comentarios

Un MouseBinding asocia un MouseGesture objeto a con una ICommand implementación. RoutedCommand es la implementación principal de la ICommand interfaz para el sistema de comandos de WPF. En general, cuando MouseGesture se ejecuta , se invoca el comando , aunque el comportamiento del comando se ve afectado por factores específicos del comando, como el CanExecute valor. Para obtener más información sobre el comando, vea Información general sobre comandos.

Al definir en MouseBinding lenguaje de marcado extensible de aplicaciones (XAML), hay dos maneras de especificar .MouseGesture La primera manera de establecer un MouseBinding en XAML es definir el Gesture atributo del MouseBinding elemento , que permite que una sintaxis especifique acciones y modificadores del mouse como una sola cadena; por ejemplo, "CTRL+LeftClick". La segunda forma es definir el MouseAction atributo del MouseBinding elemento. Ambas formas de establecer MouseGesture son equivalentes y modifican el mismo objeto subyacente, pero habrá un conflicto si se usan ambos. En el caso de que se establezcan los MouseAction atributos y Gesture , el gesto no es válido. En general, se recomienda usar solo el Gesture atributo de XAML, incluso si no se especifican modificadores; esto evita ambigüedad, proporciona la sintaxis más simplificada y proporciona la representación más sencilla para la serialización.

Se MouseBinding puede definir en un objeto específico o en el nivel de clase registrando un RegisterClassInputBinding elemento en la CommandManager clase . La manera más habitual de definir un MouseBinding elemento está dentro de la plantilla de control, estableciendo la InputBindings propiedad en XAML declarando uno o varios MouseBinding elementos.KeyBinding

Constructores

Nombre	Description
MouseBinding()	Inicializa una nueva instancia de la clase MouseBinding.
MouseBinding(ICommand, MouseGesture)	Inicializa una nueva instancia de la MouseBinding clase utilizando el comando y el gesto de mouse especificados.

Campos

Nombre	Description
MouseActionProperty	Identifica la MouseAction propiedad de dependencia.

Propiedades

Nombre	Description
CanFreeze	Obtiene un valor que indica si el objeto se puede hacer no modificable. (Heredado de Freezable)
Command	Obtiene o establece el ICommand asociado a este enlace de entrada. (Heredado de InputBinding)
CommandParameter	Obtiene o establece los datos específicos del comando para un comando determinado. (Heredado de InputBinding)
CommandTarget	Obtiene o establece el elemento de destino del comando. (Heredado de InputBinding)
DependencyObjectType	Obtiene el DependencyObjectType objeto que encapsula el tipo CLR de esta instancia. (Heredado de DependencyObject)
Dispatcher	Obtiene el objeto al que DispatcherDispatcherObject está asociado. (Heredado de DispatcherObject)
Gesture	Obtiene o establece el gesto asociado a este MouseBindingobjeto .
IsFrozen	Obtiene un valor que indica si el objeto se puede modificar actualmente. (Heredado de Freezable)
IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (solo lectura). (Heredado de DependencyObject)
MouseAction	Obtiene o establece el MouseAction asociado a este MouseBindingobjeto .

Métodos

Nombre	Description
CheckAccess()	Determina si el subproceso que llama tiene acceso a este DispatcherObject. (Heredado de DispatcherObject)
ClearValue(DependencyProperty)	Borra el valor local de una propiedad. Un identificador especifica DependencyProperty la propiedad que se va a borrar. (Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)	Borra el valor local de una propiedad de solo lectura. La propiedad que se va a borrar se especifica mediante .DependencyPropertyKey (Heredado de DependencyObject)
Clone()	Crea un clon modificable de Freezable, haciendo copias profundas de los valores del objeto. Al copiar las propiedades de dependencia del objeto, este método copia expresiones (que podrían dejar de resolverse), pero no animaciones ni sus valores actuales. (Heredado de Freezable)
CloneCore(Freezable)	Copia los valores base (no animados) de las propiedades del objeto especificado.
CloneCurrentValue()	Crea un clon modificable (copia profunda) del Freezable utilizando sus valores actuales. (Heredado de Freezable)
CloneCurrentValueCore(Freezable)	Copia los valores actuales de las propiedades del objeto especificado.
CoerceValue(DependencyProperty)	Coerce el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier CoerceValueCallback función especificada en metadatos de propiedad para la propiedad de dependencia tal como existe en la llamada DependencyObjecta . (Heredado de DependencyObject)
CreateInstance()	Inicializa una nueva instancia de la clase Freezable. (Heredado de Freezable)
CreateInstanceCore()	Crea una instancia de .MouseBinding
Equals(Object)	Determina si un proporcionado DependencyObject es equivalente al objeto actual DependencyObject. (Heredado de DependencyObject)
Freeze()	Hace que el objeto actual no se pueda modificar y establezca su IsFrozen propiedad trueen . (Heredado de Freezable)
FreezeCore(Boolean)	Hace que el Freezable objeto no se pueda modificar o compruebe si se puede hacer no modificable. (Heredado de Freezable)
GetAsFrozen()	Crea una copia inmovilizada de , Freezablemediante valores de propiedad base (no animados). Dado que la copia está inmovilizada, los sub-objetos congelados se copian por referencia. (Heredado de Freezable)
GetAsFrozenCore(Freezable)	Crea la instancia de un clon inmovilizado del especificado Freezable mediante valores de propiedad base (no animados).
GetCurrentValueAsFrozen()	Crea una copia inmovilizada de mediante los valores de Freezable propiedad actuales. Dado que la copia está inmovilizada, los sub-objetos congelados se copian por referencia. (Heredado de Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Crea la instancia actual de un clon inmovilizado del especificado Freezable. Si el objeto tiene propiedades de dependencia animadas, se copian sus valores animados actuales.
GetHashCode()	Obtiene un código hash para este DependencyObjectobjeto . (Heredado de DependencyObject)
GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia tienen valores establecidos localmente en este DependencyObject. (Heredado de DependencyObject)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de .DependencyObject (Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo de la propiedad de dependencia especificada. (Heredado de DependencyObject)
OnChanged()	Se llama cuando se modifica el objeto actual Freezable . (Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Este miembro admite la infraestructura de Windows Presentation Foundation (WPF) y no está pensada para usarse directamente desde el código. (Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Garantiza que los punteros de contexto adecuados se establecen para un DependencyObjectType miembro de datos que se acaba de establecer. (Heredado de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invalida la DependencyObject implementación de OnPropertyChanged(DependencyPropertyChangedEventArgs) para invocar también los Changed controladores en respuesta a una propiedad de dependencia cambiante de tipo Freezable. (Heredado de Freezable)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si existe. (Heredado de DependencyObject)
ReadPreamble()	Garantiza que Freezable se accede a desde un subproceso válido. Los heredadores de Freezable deben llamar a este método al principio de cualquier API que lea miembros de datos que no sean propiedades de dependencia. (Heredado de Freezable)
SetCurrentValue(DependencyProperty, Object)	Establece el valor de una propiedad de dependencia sin cambiar su origen de valor. (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia. (Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Establece el valor local de una propiedad de dependencia de solo lectura, especificada por el DependencyPropertyKey identificador de la propiedad de dependencia. (Heredado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia proporcionada. (Heredado de DependencyObject)
VerifyAccess()	Exige que el subproceso de llamada tenga acceso a este DispatcherObject. (Heredado de DispatcherObject)
WritePostscript()	Genera el Changed evento para e Freezable invoca su OnChanged() método . Las clases que derivan de Freezable deben llamar a este método al final de cualquier API que modifique los miembros de clase que no se almacenan como propiedades de dependencia. (Heredado de Freezable)
WritePreamble()	Comprueba que Freezable no está inmovilizado y que se accede a él desde un contexto de subproceso válido. Freezable Los heredares deben llamar a este método al principio de cualquier API que escriba en miembros de datos que no sean propiedades de dependencia. (Heredado de Freezable)

Eventos

Nombre	Description
Changed	Se produce cuando se modifica o Freezable un objeto que contiene. (Heredado de Freezable)

Consulte también

• MouseGesture
• KeyBinding
• CommandBinding
• RoutedCommand