《深入浅出WPF》笔记——命令篇

 一、认识命令

1.1命令的特点

  提到“命令”,我们应该想到命令的发出者,命令的接受者,命令的内容,准备工作,完成任务,回报工作。。。与事件中的发送者,接受者,消息,处理,处理,处理一一对应,如果是单纯的几个对应关系,的确用事件是能够代替的,不过,命令相对事件有其自己的特点的。比如,古时候,如果两个部落发动战争,经常在出军之前,做了充分的准备,才可能一声令下,冲啊!相反,如果没有准备好的话,一定会限制,军队不能随意出军,所以命令具有限制性。除此之外,命令一旦下达是不经常更改的。如在软件里面,一般Ctr+C命令是复制,没有哪个软件用这个命令表示粘贴的呢?所以说命令具有普遍性,除此之外,命令有自己的元素,这让程序员定义命令的时间,有章可依,所以命令更具有规范性。上面的特点纯属个人理解,可能这些性质不是非常严格。除此之外,很多网友对命令的使用褒贬不一,此文重在理解命令,所以上面特点仅供用于理解命令。

1.2WPF中命令的组成元素以及元素之间的关系

  由上面的介绍,应该可以猜出个大概了。下面直接给出其组成元素:

  • 命令(Command)实现了ICommand接口的类,使用比较多的是RoutedCommand。
  • 命令源(Command Source)命令的发送者,现实了ICommandSource接口的类,实现此类的元素主要有ButtonBase,Hyperlink,MenuItem、ListBoxItem等
  • 命令目标(Command Target)命令的接受者,实现了IInputElement接口的类。
  • 命令关联(Command Binding)负责把外围的逻辑与命令关联起来。

  相对事件的元素来说,命令元素之间的关系还是会复杂一些,具体的关系会通过命令的使用来说明。下面先简单介绍一下自定义命令的步骤。 

  a、创建命令类

  如果命令没有涉及到业务逻辑的话,一般使用WPF类库的RoutedCommand类即可,如果要声明相对逻辑复杂一些的类,可以实现RouteCommand类的继承或者是ICommand的接口。

  b、声明命令实例

  由于命令的普遍性,一般情况下程序中某类命令只需要一个命令实例即可(单件模式)。

  c、指明命令的源

  通常是可以点击的控件,命令还有个好处就是,没有准备好的命令,这个控件不可用。如果把命令看做炮弹,那么命令源相当于火炮,这个火炮还是防走火的。

  d、指明命令的目标

  目标是命令的作用对象。如果指定了目标,无论是否有焦点,都会受到这个命令。如果没有指定目标的话,拥有焦点的对象默认为命令目标。还有一个要注意的是设置目标是通过命名的源来设置的。格式为:命令源控件.CommandTarget = 目标控件;

   e、设置命令关联

   关于设置命令关联还是在实例中好好的体会一下吧。下面就通过一个例子来说明。

二、小试命令

   下面的例子实现的是点击按钮时,清除文本框里面的内容。由于代码注释写的比较详细,直接给代码,然后具体再解释:

XAML代码:

<Window x:Class="Chapter_07.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
       Background="LightBlue" Title="MainWindow" Height="230" Width="260">
    <StackPanel x:Name="stackPanel">
        <Grid x:Name="grid" Margin="10">
            <Button x:Name="button1" Content="Clear Commend"  Height="50" Margin="0,10,0,440"/>
            <TextBox x:Name="textBoxA" Margin="0,65,0,325" />
        </Grid>
    </StackPanel>
</Window>

后台代码:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;

namespace Chapter_07
{
    /// <summary>
    /// MainWindow.xaml 的交互逻辑
    /// </summary>
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();

            //初始化命令
            InitializeCommand();
        }

        //声明并定义命令
        private RoutedCommand clearCmd = new RoutedCommand("Clear",typeof(MainWindow));
        
        //初始化命令方法
        private void InitializeCommand()
        { 
            //把命令赋值给命令源,并指定快捷键
            this.button1.Command = this.clearCmd;
            this.clearCmd.InputGestures.Add(new KeyGesture(Key.C,ModifierKeys.Alt));
            //为命令设置目标
            this.button1.CommandTarget = this.textBoxA;
            
            //创建命令关联
            CommandBinding cb = new CommandBinding();
            //指定关联的命令
            cb.Command = this.clearCmd;
            //确定此命令是否可以在其当前状态下执行
            cb.CanExecute += cb_CanExecute;
            //调用此命令
            cb.Executed += cb_Executed;
            
            //把命令关联到外围控件上
            this.stackPanel.CommandBindings.Add(cb);
        }
        
        //执行命令,要做的事情
        void cb_Executed(object sender, ExecutedRoutedEventArgs e)
        {
            this.textBoxA.Clear();
            e.Handled = true;
        }

        //在执行命令之前,检查命令是否可以执行对应的处理器
        void cb_CanExecute(object sender, CanExecuteRoutedEventArgs e)
        {
            if (string.IsNullOrEmpty(this.textBoxA.Text))
            {
                e.CanExecute = false;
            }
            else
            {
                e.CanExecute = true;
            }
            e.Handled = true;
        }
    }
}

效果是:文本框没有输入内容的话,按钮是不可用的,当文本框里面有文字的话,按钮可用,点击按钮清除文本框内容。效果如图1:

图1

   通过效果图,应该基本上了解路由命令的,我在看书的时间,想起了一个问题,为什么叫路由命令,应该是与路由事件有关,后来又翻了一遍书,发现路由事件在下面图中有提及到,在上面的代码中,站在高处的元素StackPanel作为CommandBinding的载体(由于路由事件的传播是在可视树上传播的,所以CommandBinding的载体一定为命令目标的外围控件上面),CommandBinding来指定监听命令是否准备好的事件和命令的处理事件,然后告诉命令,由于命令源拥有命令的实例,命令源就会根据命令接到的信息,作出相应的反应,在此处,命令只是捕捉信息和通知命令源,真正其作用的是CommandBinding指定的处理器。

   图2

 三、WPF的命令库

   在WPF中微软提供了一些便捷的命令库: ApplicationCommandsMediaCommandsComponentCommandsNavigationCommandsEditingCommands。下面通过一个例子来说明调用ApplicationCommands的Copy命令。点击按钮,把文本框内容拷贝到另外一个文本框里面。 

XAML代码如下:

<Window x:Class="Chapter_07.Window1"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Window1" Height="300" Width="300" Background="Azure">
    <StackPanel x:Name="stackpanel">
        <TextBox x:Name="txt1" Margin="10" />
        <TextBox x:Name="txt2" Margin="10" />
        <Button x:Name="button1" Content="按钮一" Height="50" Margin="10" Command="ApplicationCommands.Copy"/>
    </StackPanel>
    <Window.CommandBindings>
        <CommandBinding Command="Copy" CanExecute="Copy_CanExecute" Executed="Copy_Executed"/>
    </Window.CommandBindings>
</Window>

后台代码:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Shapes;

namespace Chapter_07
{
    /// <summary>
    /// Window1.xaml 的交互逻辑
    /// </summary>
    public partial class Window1 : Window
    {
        public Window1()
        {
            InitializeComponent();
        }

        private void Copy_Executed(object sender, ExecutedRoutedEventArgs e)
        {
            this.txt2.Text = this.txt1.Text;
        }

        private void Copy_CanExecute(object sender, CanExecuteRoutedEventArgs e)
        {
            //检查是否能发出命令
             e.CanExecute = !string.IsNullOrEmpty(this.txt1.Text);
            e.Handled = false;
        }
    }
}

  上面的例子是把Window作为CommandBinding的载体,而且是在XAML中实现的,注意与在后台代码上的区别,简单的一个Copy功能就实现了。虽然说微软提供了WPF类库,但是处理函数还是要我们自己去写的。还有一点要注意的是:可以用转到定义查看ApplicationCommands类与其类里面的属性,他们都是静态的,所以都以单件模式出现。如果有两个命令源,同使用一个“命令”,那么应该怎么区别?原来命令源除了含有Command属性,还含有CommandParmeter属性,用来区分不同的命令源。在处理的时间,根据e.Parameter(如图3)来获取是哪个源发出的命令,来采取相应的命令。关于其他的WPF类库如果有用到的话再查msdn了。

图3

 四、自定义命令

   在小试命令的例子中,记录了自定义RoutedCommand,路由命令中真正做事情的是CommandBinding。下面主要记录一下自定义直接实现ICommand接口的命令。在介绍之前,先看一下ICommand接口的原型:

  • event EventHandler CanExecuteChanged;
  • bool CanExecute(object parameter);
  • void Execute(object parameter);

  其中第一个事件为,当命令可执行状态发生改变时,可以激化此事件来通知其他对象。另外两个方法在上面已经用过同名的,在此不做重复说明。下面开始实现一个自定义直接实现ICommand接口的命令,同样实现点击源控件,清除目标控件的内容:

a.准备工作:

    //为了使目标控件,含有Clear()方法,所以在此一个定义接口
    public interface IView
    {
        void Clear();
    }
    
    //定义命令
    public class ClearCommand : ICommand
    {
        public event EventHandler CanExecuteChanged;

        public bool CanExecute(object parameter)
        {
            throw new System.NotImplementedException();
        }

        public void Execute(object parameter)
        {
            IView view = parameter as IView;
            if (view != null)
            {
                view.Clear();
            }
        }
    }

    //自定义命令源
    public class MyCommandSource : System.Windows.Controls.UserControl, ICommandSource
    {
        public ICommand Command { get; set; }

        public object CommandParameter { get; set; }

        public IInputElement CommandTarget { get; set; }

        //重写点击处理函数,注意由于事件的优先级不同,如果命令源是button的话,下面的函数不起作用
        protected override void OnMouseLeftButtonDown(MouseButtonEventArgs e)
        {
            base.OnMouseLeftButtonDown(e);

            if (this.CommandTarget != null)
            {
                this.Command.Execute(this.CommandTarget);
            }
        }
    }

b.制作一个userControl控件。

XAML
<UserControl x:Class="Chapter_07.MiniView"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             Height="140"  Width="200">
    <Border CornerRadius="5" BorderBrush="LawnGreen" BorderThickness="2" >
        <StackPanel >
            <TextBox x:Name="textBox1" Margin="5"/>
            <TextBox x:Name="textBox2" Margin="5"/>
            <TextBox x:Name="textBox3" Margin="5"/>
            <TextBox x:Name="textBox4" Margin="5"/>
        </StackPanel>
    </Border>
</UserControl>
MiniView.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;

namespace Chapter_07
{
    /// <summary>
    /// MiniView.xaml 的交互逻辑
    /// </summary>
    public partial class MiniView : UserControl,IView
    {
        public MiniView()
        {
            InitializeComponent();
        }

        public void Clear()
        {
            this.textBox1.Clear();
            this.textBox2.Clear();
            this.textBox3.Clear();
            this.textBox4.Clear();
        }
    }
}

c.制作自定义命令界面。

<Window x:Class="Chapter_07.DefineCommand"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:Chapter_07"
        Title="DefineCommand" Height="300" Width="300">
    <StackPanel>
        <local:MyCommandSource x:Name="ctrClear" Margin="10">
            <TextBlock Text="清除" FontSize="16" TextAlignment="Center" Background="LightGreen" Width="80"/>
        </local:MyCommandSource>
        <local:MiniView x:Name="miniView"/>
    </StackPanel>
</Window>
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Shapes;

namespace Chapter_07
{
    /// <summary>
    /// DefineCommand.xaml 的交互逻辑
    /// </summary>
    public partial class DefineCommand : Window
    {
        public DefineCommand()
        {
            InitializeComponent();
            //下面的声明命令方式,仅作为练习使用,由于命令
            //具有"全局性",所以一般声明在静态全局的地方,供全局使用
            ClearCommand clearCmd = new ClearCommand();
            this.ctrClear.Command = clearCmd;
            this.ctrClear.CommandTarget = this.miniView;
        }
    }
}

终于黏贴完了,弱弱的看一下效果吧!

 图4

  本例纯属笔记,但是涉及到的东西还是比较多的,包括接口、自定义控件以及命令的几个组成元素,对于菜鸟的自己,如果细心的看几遍还是能小有所获的。

 五、总结

   本文主要通过简单的例子,认识了RoutedCommand和ICommand的自定义命令以及微软的WPF提供的命令库,虽然上面的例子比较简单,但是里面涉及的东西还是很有必要时常查阅的。本文是读书笔记,里面难免有理解不对的地方,欢迎讨论!下一篇:《深入浅出WPF》笔记——资源篇。

posted @ 2012-09-25 23:34  haiziguo  阅读(10242)  评论(6编辑  收藏  举报