Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

MouseBinding (Clase)

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

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

public class MouseBinding : InputBinding

El tipo MouseBinding expone los siguientes miembros.

  NombreDescripción
Método públicoMouseBinding()Inicializa una nueva instancia de la clase MouseBinding.
Método públicoMouseBinding(ICommand, MouseGesture)Inicializa una nueva instancia de la clase MouseBinding utilizando el comando y el movimiento del mouse especificados.
Arriba

  NombreDescripción
Propiedad públicaCanFreezeObtiene un valor que indica si el objeto se puede convertir en no modificable. (Se hereda de Freezable).
Propiedad públicaCommandObtiene o establece la interfaz ICommand asociada a este enlace de entrada. (Se hereda de InputBinding).
Propiedad públicaCommandParameterObtiene o establece los datos específicos de un comando concreto. (Se hereda de InputBinding).
Propiedad públicaCommandTargetObtiene o establece el elemento de destino del comando. (Se hereda de InputBinding).
Propiedad públicaDependencyObjectTypeObtiene el objeto DependencyObjectType que ajusta el tipo CLR de esta instancia.  (Se hereda de DependencyObject).
Propiedad públicaDispatcherObtiene el objeto Dispatcher al que está asociado DispatcherObject. (Se hereda de DispatcherObject).
Propiedad públicaGestureObtiene o establece el movimiento asociado a este MouseBinding. (Invalida a InputBinding.Gesture).
Propiedad públicaIsFrozenObtiene un valor que indica si el objeto es modificable actualmente. (Se hereda de Freezable).
Propiedad públicaIsSealedObtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura). (Se hereda de DependencyObject).
Propiedad públicaMouseActionObtiene o establece el objeto MouseAction asociado a este objeto MouseBinding.
Arriba

  NombreDescripción
Método públicoCheckAccess Determina si el subproceso de la llamada tiene acceso a este DispatcherObject. (Se hereda de DispatcherObject).
Método públicoClearValue(DependencyProperty) Borra el valor local de una propiedad. La propiedad que se borrará se especifica mediante un identificador de DependencyProperty. (Se hereda de DependencyObject).
Método públicoClearValue(DependencyPropertyKey) Borra el valor local de una propiedad de sólo lectura. La propiedad que se borrará es especificada por DependencyPropertyKey. (Se hereda de DependencyObject).
Método públicoCloneCrea un clon modificable del objeto Freezable y hace copias en profundidad de sus valores. Al copiar las propiedades de dependencia del objeto, este método copia las expresiones (que puede que ya no se resuelvan) pero no las animaciones ni sus valores actuales. (Se hereda de Freezable).
Método protegidoCloneCoreCopia los valores base (sin animaciones) de las propiedades del objeto especificado. (Invalida a InputBinding.CloneCore(Freezable)).
Método públicoCloneCurrentValueCrea un clon modificable (copia en profundidad) de Freezable con sus valores actuales. (Se hereda de Freezable).
Método protegidoCloneCurrentValueCoreCopia los valores actuales de las propiedades del objeto especificado. (Invalida a InputBinding.CloneCurrentValueCore(Freezable)).
Método públicoCoerceValue Fuerza el valor de propiedad de la dependencia especificada. Esto se logra a cualquier función de CoerceValueCallback especificada en los metadatos de propiedad para la propiedad de dependencia tal como existe en el objeto DependencyObject que llama. (Se hereda de DependencyObject).
Método protegidoCreateInstanceInicializa una nueva instancia de la clase Freezable. (Se hereda de Freezable).
Método protegidoCreateInstanceCoreCrea una instancia de un objeto MouseBinding. (Invalida a InputBinding.CreateInstanceCore()).
Método públicoEquals Determina si un DependencyObject proporcionado es equivalente a DependencyObject actual. (Se hereda de DependencyObject).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Se hereda de Object).
Método públicoFreeze()Convierte el objeto actual en no modificable y establece su propiedad IsFrozen en true. (Se hereda de Freezable).
Método protegidoFreezeCoreConvierte el objeto Freezable en no modificable o prueba si se puede convertir en no modificable. (Se hereda de Freezable).
Método públicoGetAsFrozenCrea una copia inmovilizada de Freezable, con los valores de la propiedad base (no animada). Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia. (Se hereda de Freezable).
Método protegidoGetAsFrozenCoreCrea la instancia en un clon inmovilizado del objeto Freezable especificado mediante los valores base de la propiedad (sin animaciones). (Invalida a InputBinding.GetAsFrozenCore(Freezable)).
Método públicoGetCurrentValueAsFrozenCrea una copia inmovilizada de Freezable con los valores de propiedad actuales. Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia. (Se hereda de Freezable).
Método protegidoGetCurrentValueAsFrozenCoreCrea la instancia actual en un clon inmovilizado de la clase Freezable especificada. Si el objeto tiene propiedades de dependencia animadas, se copian sus valores animados actuales. (Invalida a InputBinding.GetCurrentValueAsFrozenCore(Freezable)).
Método públicoGetHashCode Obtiene un código hash para este DependencyObject. (Se hereda de DependencyObject).
Método públicoGetLocalValueEnumeratorCrea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject. (Se hereda de DependencyObject).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoGetValue Devuelve el valor efectivo actual de propiedad de dependencia en esta instancia de DependencyObject. (Se hereda de DependencyObject).
Método públicoInvalidatePropertyVuelve a evaluar el valor efectivo para la propiedad de dependencia especificada. (Se hereda de DependencyObject).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoOnChangedSe llama cuando se modifica el objeto Freezable actual. (Se hereda de Freezable).
Método protegidoOnFreezablePropertyChanged(DependencyObject, DependencyObject)Se asegura de que se establecen los punteros contextuales adecuados para un miembro de datos DependencyObjectType que se acaba de establecer. (Se hereda de Freezable).
Método protegidoOnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)Este miembro admite la infraestructura de Windows Presentation Foundation (WPF) y no se debe usar directamente desde el código. (Se hereda de Freezable).
Método protegidoOnPropertyChangedInvalida la implementación de DependencyObject de OnPropertyChanged para invocar también cualquier controlador Changed como respuesta a un cambio de propiedad de dependencia de tipo Freezable. (Se hereda de Freezable).
Método públicoReadLocalValue Devuelve el valor local de propiedad de dependencia, si existe. (Se hereda de DependencyObject).
Método protegidoReadPreambleSe asegura de que se tiene acceso a Freezable desde un subproceso válido. Los herederos de Freezable deben llamar a este método al inicio de las API que lean miembros de datos que no son propiedades de dependencia. (Se hereda de Freezable).
Método públicoSetCurrentValueEstablece el valor de una propiedad de dependencia sin cambiar el origen de su valor. (Se hereda de DependencyObject).
Método públicoSetValue(DependencyProperty, Object)Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia. (Se hereda de DependencyObject).
Método públicoSetValue(DependencyPropertyKey, Object)Establece el valor local de una propiedad de dependencia de sólo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia. (Se hereda de DependencyObject).
Método protegidoShouldSerializePropertyDevuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia proporcionada. (Se hereda de DependencyObject).
Método públicoToString Devuelve una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoVerifyAccessExige que el subproceso de la llamada tenga acceso a DispatcherObject. (Se hereda de DispatcherObject).
Método protegidoWritePostscriptProvoca el evento Changed de Freezable e invoca su método OnChanged. Las clases que se derivan de Freezable deben llamar a este método al final de cualquier API que modifique miembros de clase que no se almacenen como propiedades de dependencia. (Se hereda de Freezable).
Método protegidoWritePreambleComprueba que no se inmovilice Freezable y que se tiene acceso desde un contexto de subproceso válido. Los herederos de Freezable deben llamar a este método al inicio de cualquier API que escriba en miembros de datos que no sean propiedades de dependencia. (Se hereda de Freezable).
Arriba

  NombreDescripción
Evento públicoChangedSe produce cuando se modifican la clase Freezable o un objeto que la contiene. (Se hereda de Freezable).
Arriba

  NombreDescripción
Campo públicoMiembro estáticoMouseActionPropertyIdentifica la propiedad de dependencia MouseAction.
Arriba

MouseBinding asocia MouseGesture con una implementación ICommand. RoutedCommand es la implementación primaria de la interfaz ICommand para el sistema de comandos WPF. En general, cuando se ejecuta MouseGesture, se invoca el comando, aunque hay otros factores específicos del comando, como el valor de CanExecute, que influyen aún más en el comportamiento del comando. Para obtener más información sobre los comandos, vea Información general sobre comandos.

Al definir MouseBinding en Extensible Application Markup Language (XAML), existen dos formas de especificar MouseGesture. La primera forma de establecer MouseBinding en XAML consiste en definir el atributo Gesture del elemento MouseBinding, que permite que una sintaxis especifique acciones del mouse y modificadores como una cadena única; por ejemplo, "CTRL+clic con el botón primario". La segunda forma consiste en definir el atributo MouseAction del elemento MouseBinding. Las dos formas de establecer el valor de MouseGesture son equivalentes y modifican el mismo objeto subyacente, pero se producirá un conflicto si se usan ambas. En caso de que esté establecido tanto el atributo MouseAction como el atributo Gesture, el movimiento no será válido. En general, se recomienda utilizar únicamente el atributo Gesture de XAML, incluso si no se especifican modificadores; de este modo, se evitan ambigüedades, se optimiza la sintaxis y se proporciona la representación más sencilla para la serialización.

Se puede definir un enlace MouseBinding en un objeto concreto o en el nivel de clase registrando un método RegisterClassInputBinding en la clase CommandManager. La forma más habitual de definir MouseBinding es dentro de la plantilla de control, estableciendo la propiedad InputBindings en XAML mediante la declaración de uno o más elementos MouseBinding o KeyBinding.

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


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



			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)



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);


.NET Framework

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

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.

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.
Mostrar: