| File: System\Windows\Input\Command\MouseBinding.cs | Web Access |
| Project: src\wpf\src\Microsoft.DotNet.Wpf\src\PresentationCore\PresentationCore.csproj (PresentationCore) |
// Licensed to the .NET Foundation under one or more agreements. // The .NET Foundation licenses this file to you under the MIT license. // Description: The MouseBinding class is used by the developer to create Mouse Input Bindings // // See spec at : http://avalon/coreui/Specs/Commanding(new).mht // //* MouseBinding class serves the purpose of Input Bindings for Mouse Device. using System.Windows.Markup; using System.ComponentModel; namespace System.Windows.Input { /// <summary> /// MouseBinding - Implements InputBinding (generic InputGesture-Command map) /// MouseBinding acts like a map for MouseGesture and Commands. /// Most of the logic is in InputBinding and MouseGesture, this only /// facilitates user to specify MouseAction directly without going in /// MouseGesture path. Also it provides the MouseGestureTypeConverter /// on the Gesture property to have MouseGesture, like "RightClick" /// defined in Markup as Gesture="RightClick" working. /// </summary> public class MouseBinding : InputBinding { //------------------------------------------------------ // // Constructors // //------------------------------------------------------ #region Constructors /// <summary> /// constructor /// </summary> public MouseBinding() : base() { } /// <summary> /// Constructor /// </summary> /// <param name="command">Command Associated</param> /// <param name="mouseAction">Mouse Action</param> internal MouseBinding(ICommand command, MouseAction mouseAction) : this(command, new MouseGesture(mouseAction)) { } /// <summary> /// Constructor /// </summary> /// <param name="command">Command Associated</param> /// <param name="gesture">Mmouse Gesture associated</param> public MouseBinding(ICommand command, MouseGesture gesture) : base(command, gesture) { SynchronizePropertiesFromGesture(gesture); // Hooking the handler explicitly becuase base constructor uses _gesture // It cannot use Gesture property itself because it is a virtual gesture.PropertyChanged += new PropertyChangedEventHandler(OnMouseGesturePropertyChanged); } #endregion Constructors //------------------------------------------------------ // // Properties // //------------------------------------------------------ #region Properties /// <summary> /// MouseGesture /// </summary> [TypeConverter(typeof(MouseGestureConverter))] [ValueSerializer(typeof(MouseGestureValueSerializer))] public override InputGesture Gesture { get { return base.Gesture as MouseGesture; } set { MouseGesture oldMouseGesture = Gesture as MouseGesture; MouseGesture mouseGesture = value as MouseGesture; if (mouseGesture != null) { base.Gesture = mouseGesture; SynchronizePropertiesFromGesture(mouseGesture); if (oldMouseGesture != mouseGesture) { oldMouseGesture?.PropertyChanged -= new PropertyChangedEventHandler(OnMouseGesturePropertyChanged); mouseGesture.PropertyChanged += new PropertyChangedEventHandler(OnMouseGesturePropertyChanged); } } else { throw new ArgumentException(SR.Format(SR.InputBinding_ExpectedInputGesture, typeof(MouseGesture))); } } } /// <summary> /// Dependency property for MouseAction /// </summary> public static readonly DependencyProperty MouseActionProperty = DependencyProperty.Register("MouseAction", typeof(MouseAction), typeof(MouseBinding), new UIPropertyMetadata(MouseAction.None, new PropertyChangedCallback(OnMouseActionPropertyChanged))); /// <summary> /// MouseAction /// </summary> public MouseAction MouseAction { get { return (MouseAction)GetValue(MouseActionProperty); } set { SetValue(MouseActionProperty, value); } } private static void OnMouseActionPropertyChanged(DependencyObject d, DependencyPropertyChangedEventArgs e) { MouseBinding mouseBinding = (MouseBinding)d; mouseBinding.SynchronizeGestureFromProperties((MouseAction)(e.NewValue)); } #endregion #region Freezable protected override Freezable CreateInstanceCore() { return new MouseBinding(); } protected override void CloneCore(Freezable sourceFreezable) { base.CloneCore(sourceFreezable); CloneGesture(); } protected override void CloneCurrentValueCore(Freezable sourceFreezable) { base.CloneCurrentValueCore(sourceFreezable); CloneGesture(); } protected override void GetAsFrozenCore(Freezable sourceFreezable) { base.GetAsFrozenCore(sourceFreezable); CloneGesture(); } protected override void GetCurrentValueAsFrozenCore(Freezable sourceFreezable) { base.GetCurrentValueAsFrozenCore(sourceFreezable); CloneGesture(); } #endregion #region Private Methods /// <summary> /// Synchronized Properties from Gesture /// </summary> private void SynchronizePropertiesFromGesture(MouseGesture mouseGesture) { if (!_settingGesture) { _settingGesture = true; try { MouseAction = mouseGesture.MouseAction; } finally { _settingGesture = false; } } } /// <summary> /// Synchronized Gesture from properties /// </summary> private void SynchronizeGestureFromProperties(MouseAction mouseAction) { if (!_settingGesture) { _settingGesture = true; try { if (Gesture == null) { Gesture = new MouseGesture(mouseAction); } else { ((MouseGesture)Gesture).MouseAction = mouseAction; } } finally { _settingGesture = false; } } } private void OnMouseGesturePropertyChanged(object sender, PropertyChangedEventArgs e) { if (string.Equals(e.PropertyName, "MouseAction", StringComparison.Ordinal)) { MouseGesture mouseGesture = Gesture as MouseGesture; if (mouseGesture != null) { SynchronizePropertiesFromGesture(mouseGesture); } } } private void CloneGesture() { MouseGesture mouseGesture = Gesture as MouseGesture; mouseGesture?.PropertyChanged += new PropertyChangedEventHandler(OnMouseGesturePropertyChanged); } #endregion //------------------------------------------------------ // // Private Fields // //------------------------------------------------------ #region Data private bool _settingGesture = false; #endregion } }