第九章 深入浅出话命令

第九章 深入浅出话命令

事件的作用是发布、传播一些消息，消息送达接收者，事件的使命也就完成了，每个接收者使用自己的行为来相应事件。事件不具有约束力，命令具有约束力，不仅可以约束代码，还可以约束步骤逻辑。

• 命令：ICommand接口的类，常用的是RoutedCommand类，也可以自定义类。
• 命令源：命令的发送者，ICommandSource接口的类。
• 命令目标：命令发给谁，或者命令作用在谁身上。IInputElement接口的类。
• 命令关联：把一些外围逻辑与命令关联起来，如进行逻辑判断、后续处理等。

示例：用Button发送一个命令，当命令到达TextBox时TextBox会被清空（如果TextBox中没有文字则命令不可被发送）。

<Window x:Class="WpfApplication1_2.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Background="LightBlue"
        Title="MainWindow" Height="175" Width="260">
    <StackPanel x:Name="stackPanel">
        <Button x:Name="button1" Content="Send Command" Margin="5"/>
        <TextBox x:Name="textBoxA" Margin="5" Height="100"/>
    </StackPanel>
</Window>

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

        //声明并定义命令，一处声明、处处使用
        private RoutedCommand clear_Cmd = new RoutedCommand("Clear", typeof(MainWindow));

        private void InitializeCommand()
        {
            //把命令赋值给发送者（命令源）并指定快捷键
            this.button1.Command = this.clear_Cmd;
            this.clear_Cmd.InputGestures.Add(new KeyGesture(Key.C,ModifierKeys.Alt));

            //指定命令目标
            this.button1.CommandTarget = this.textBoxA;

            //创建命令关联
            CommandBinding cb = new CommandBinding();
            cb.Command = this.clear_Cmd;//只关注与clear_Cmd相关的事件
            cb.CanExecute += new CanExecuteRoutedEventHandler(cb_CanExecute);
            cb.Executed += new ExecutedRoutedEventHandler(cv_Executed);

            //把命令关联安置在外围控件上
            this.stackPanel.CommandBindings.Add(cb);
        }

        //当探测命令可以执行时，此方法被调用
        void cb_CanExecute(object sender, CanExecuteRoutedEventArgs e)
        {
            if(string.IsNullOrEmpty(this.textBoxA.Text))
                { e.CanExecute = false; }
                else
                {e.CanExecute=true ;}

            //避免继续向上传而降低程序性能
            e.Handled=true;
        }

        //当命令送达目标后，此方法被调用
        void cv_Executed(object sender, ExecutedRoutedEventArgs e)
        {
            this.textBoxA.Clear();

            //避免继续向上传而降低程序性能
            e.Handled = true;
        }
    }
}

RoutedCommand只负责在程序中“跑腿”而并不对命令目标做任何操作，由CommandBinding完成操作，CommandBinding一定要设置在命令目标的外围控件上，不然无法捕捉cb_CanExecute、cv_Executed。

WPF 的命令库

WPF类库里的便捷命令库(都是静态类)：

• ApplicationCommands
• ComponentCommands
• NavigationCommands
• MediaCommands
• EditingCommands

示例：界面上有两个按钮，一个新建Teacher档案、一个新建Student档案。都使用New命令，但通过CommandParameter来区别新建类别的不同。（这里使用XAML为窗体添加CommandBinding、CanExecute、Executed）

<Window x:Class="WpfApplication1_2.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="MainWindow" Height="240" Width="360" Background="LightBlue" WindowStyle="ToolWindow">
    <Grid Margin="6">
        <Grid.RowDefinitions>
            <RowDefinition Height="24"/>
            <RowDefinition Height="4"/>
            <RowDefinition Height="24"/>
            <RowDefinition Height="4"/>
            <RowDefinition Height="24"/>
            <RowDefinition Height="4"/>
            <RowDefinition Height="*"/>
        </Grid.RowDefinitions>
        <!--下面代码是命令和命令参数-->
        <TextBlock Text="Name:"  VerticalAlignment="Center" HorizontalAlignment="Left" Grid.Row="0"/>
        <TextBox x:Name="nameTextBox" Margin="60,0,0,0" Grid.Row="0"/>
        <Button Content="New Teacher" Command="New" CommandParameter="Teacher" Grid.Row="2"/>
        <Button Content="New Student" Command="New" CommandParameter="Student" Grid.Row="4"/>
        <ListBox x:Name="listBoxNewItems" Grid.Row="6"/>
    </Grid>
    <!--下列代码为窗体添加CommandBindings-->
    <Window.CommandBindings>
        <CommandBinding Command="New" CanExecute="New_CanExecute" Executed="New_Executed"/>
    </Window.CommandBindings>
</Window>

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

        private void New_CanExecute(object sender, CanExecuteRoutedEventArgs e)
        {
            if(string.IsNullOrEmpty(this.nameTextBox.Text))
            { e.CanExecute = false; }
            else
            { e.CanExecute = true; }
        }

        private void New_Executed(object sender, ExecutedRoutedEventArgs e)
        {
            string name = this.nameTextBox.Text;
            //如果是Teacher
            if(e.Parameter.ToString()=="Teacher")
            {
                this.listBoxNewItems.Items.Add(string.Format("New Teacher:{0},以其昭昭使人昭昭。", name));
            }

            //如果是Student
            if(e.Parameter.ToString()=="Student")
            {
                this.listBoxNewItems.Items.Add(string.Format("New Student:{0},童蒙！",name));
            }
        }
    }
}

近观命令

ICommand接口与RoutedCommand，这一章节没有仔细看。

自定义Command

• WPF命令库中没有自己需要的命令，需要声明定义自己的RoutedCommand实例，这是浅层次的理解，本质还是RoutedCommand的使用（WPF自带的命令源和CommandBinding就是专门为RoutedCommand编写）。

• 从实现ICommand接口开始，定义自己的命令，并把某些业务逻辑也包含在命令中（想使用自己的ICommand派生类就必须连命令源一起实现）。

为了简化CommandBinding的程序结构，将业务逻辑移入命令的Execute方法内。

//自定义接口
public interface IView  //需要将其放在MainWindow的外面，这样其他的窗体才可以引用
{
    //属性
    bool IsChanged { get; set; }

    //方法
    void SetBinding();
    void Refresh();
    void Clear();
    void Save();
    //....
}

//自定义命令源：WPF命令源是为RoutedCommand准备的，且不可重写。只能通过ICommandSource接口创建自己的命令源

namespace WpfApplication1_2
{
    /// <summary>
    /// MainWindow.xaml 的交互逻辑
    /// </summary>

    public class MyCommandSource : UserControl, ICommandSource
    {
        //继承ICommandSource的三个属性：
        public ICommand Command { get; set; }
        public object CommandParameter { get; set; }//本例中没有用到
        public IInputElement CommandTarget { get; set; }//被当作参数传递给了Command的Execute方法

        //在组件被单击时连带执行命令  //为命令选择合适时机，此处为控件被左单击时执行
        protected override void OnMouseLeftButtonDown(MouseButtonEventArgs e)
        {
            base.OnMouseLeftButtonDown(e);

            //在命令目标上执行命令，或者让命令作用于命令目标
            if (this.CommandTarget != null)
            {
                this.Command.Execute(this.CommandTarget);
            }
        }
    }

    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();

            //声明命令并使用命令源和目标与之关联
            ClearCommand clearCmd = new ClearCommand();
            this.ctrlClear.Command = clearCmd;
            this.ctrlClear.CommandTarget = this.miniView;
        }


        //自定义命令：实现ICommand接口，创建一个专门作用于IView派生类的命令
        public class ClearCommand:ICommand
        {
            //当命令可执行状态发生改变时，应当被激发
            public event EventHandler CanExecuteChanged;

            //用于判断命令是否可以执行（暂不实现）
            public bool CanExecute(object parameter)
            {
                throw new NotImplementedException();
            }

            //命令执行，带有与业务相关的Clear逻辑
            public void Execute(object parameter)
            {
                IView view = parameter as IView;
                if(view!=null)
                { 
                    view.Clear(); 
                }
            }//命令实现了ICommand接口，并继承了CanExecuteChanged事件、CanExecute和Execute方法
        }



        //至此，命令和命令源都有了。差一个可用的命令目标。因为此处ClearCommand作用于IView派生类，所以
        //ClearCommand需要实现IView接口：XAML实现UI部分，C#实现接口部分。
    }
}

<Window x:Class="WpfApplication1_2.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:WpfApplication1_2"
        Title="MainWindow" Height="205" Width="250" Background="LightBlue" WindowStyle="ToolWindow">
    <StackPanel>
        <local:MyCommandSource x:Name="ctrlClear" Margin="10">
            <TextBlock Text="清除" FontSize="16" TextAlignment="Center" Background="LawnGreen" Width="80"/>
        </local:MyCommandSource>
        <local:MiniView x:Name="miniView"/>
    </StackPanel>
</Window>

<UserControl x:Class="WpfApplication1_2.MiniView"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
             xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
             mc:Ignorable="d" 
             d:DesignHeight="114" d:DesignWidth="200">
    <Border CornerRadius="5" BorderBrush="LawnGreen" BorderThickness="2">
        <StackPanel>
            <TextBox x:Name="textBox1" Margin="5"/>
            <TextBox x:Name="textBox2" Margin="5,0"/>
            <TextBox x:Name="textBox3" Margin="5"/>
            <TextBox x:Name="textBox4" Margin="5,0"/>
        </StackPanel>
    </Border>
</UserControl>

namespace WpfApplication1_2
{
    /// <summary>
    /// MiniView.xaml 的交互逻辑
    /// </summary>
    
    //自定义命令目标
    public partial class MiniView : UserControl,IView
    {
        public MiniView()
        {
            InitializeComponent();
        }

        //继承自IView的成员们
        public bool IsChanged { get; set; }
        public void SetBinding() { }
        public void Refresh() { }
        public void Save() { }

        //用于清除内容的业务逻辑
        public void Clear()
        {
            this.textBox1.Clear();
            this.textBox2.Clear();
            this.textBox3.Clear();
            this.textBox4.Clear();
        }
    }
}

程序的流程图如下：