WPF学习—命令

摘抄自《深入浅出WPF》第九章

WPF命令系统基本要素：

1.命令（Command）：WPF命令实际上就是实现ICommand接口的类，用的最多的是RoutedCommand类

2.命令源（Command Source）：命令发送者，是实现了ICommandSource接口的类

3.命令目标（Command Target）：命令发送目标。命令目标必须是实现了IInputElement接口的类

4.命令关联（Command Binding）：负责把一些外围逻辑与命令关联起来。

命令的使用步骤：

1.创建命令类：即获得一个实现ICommand接口的类，如果命令与具体业务逻辑无关则使用WPF类库中的RoutedCommand类即可，否则需要创建RoutedCommand（或ICommand接口）的派生类

2.声明命令实例：创建命令类的实例

3.指定命令源：即指定由谁发送命令。一旦把命令指派给命令源，命令原会受命令的影响，当命令不能被执行的时候作为命令源的控件将处在不可用的状态。

4.指定命令目标：命令目标并不是命令的属性而是命令源的属性，指定命令目标是告诉命令源向哪个组件发送命令，无论这个组件是否拥有焦点它都会收到这个命令。如果没有为命令源指定命令目标，则WPF系统认为当前拥有焦点的对象就是命令目标

5.设置命令关联：WPF命令需要CommandBindng在执行前来帮助判断是不是可以执行，在执行后还要做一些事件。

WPF命令系统基本元素关系图：

实例：定义一个命令，使用Button发送，命令送达TextBox时TextBox会被清空（如果TextBox中没有文字则命令不可被送达，Button按钮不可用）

XAML界面：

<Window x:Class="SimpleCommandTest.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:SimpleCommandTest"
        mc:Ignorable="d"
        Title="MainWindow" Height="350" Width="525">
    <Grid>
        <StackPanel x:Name="stackPanel" Margin="5" Background="AliceBlue">
            <Button x:Name="button1" Content="Send Command" Margin="5"/>
            <TextBox x:Name="textBoxA" Margin="5" Height="100" TextWrapping="Wrap"/>
        </StackPanel>
    </Grid>
</Window>

后台代码：

 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 += new CanExecuteRoutedEventHandler(cb_CanExecute);
            cb.Executed += new ExecutedRoutedEventHandler(cb_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 cb_Executed(object sender,ExecutedRoutedEventArgs e)
        {
            this.textBoxA.Clear();
            e.Handled = true;
        }
    }

WPF命令库：

1.ApplicationCommands

2.ComponentCommands

3.NavigationCommands

4.MediaCommands

5.EditingCommands

带参数的命令：通过参数来决定命令要做什么事。命令源一定是实现了ICommandSource接口的对象，而ICommandSource有一个名为CommandPrameter的属性。

实例：

XAML代码

<Window x:Class="SimpleCommandPrameterTest.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:SimpleCommandPrameterTest"
        mc:Ignorable="d"
        Title="MainWindow" Height="350" Width="525">
    <Grid Margin="5" Background="AliceBlue">
        <Grid.RowDefinitions>
            <RowDefinition Height="24"/>
            <RowDefinition Height="4"/>
            <RowDefinition Height="24"/>
            <RowDefinition Height="4">
            </RowDefinition>
            <RowDefinition Height="24"/>
            <RowDefinition Height="4"/>
            <RowDefinition Height="*"/>
        </Grid.RowDefinitions>

        <TextBlock Text="Name:" VerticalAlignment="Center" HorizontalAlignment="Left" />
        <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>
    <!--为窗口添加CommandBinding-->
        <Window.CommandBindings>
        <CommandBinding Command="New" CanExecute="New_CanExecute" Executed="New_Executed"/>
    </Window.CommandBindings>
</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;
            if(e.Parameter.ToString()=="Teacher")
            {
                this.listBoxNewItems.Items.Add(string.Format("New Teacher:{0},学而不厌，诲人不倦。",name));
            }
            if(e.Parameter.ToString()=="Student")
            {
                this.listBoxNewItems.Items.Add(string.Format("New Student:{0},好好学习，天天向上。",name));
            }
            this.nameTextBox.Clear();
        }
    }

在XAML中定义了命令不同的参数，参数不同命令执行后结果不同。

自定义命令

首先创建一个WPF工程，在MainWindow.xaml.cs中定义一个接口：

public interface IView
    {
        bool IsChanged { get; set; }

        void SetBinding();
        void Refresh();
        void Clear();
        void Save();
    }

每个需要接受命令的组件必须实现这个接口，确保命令可以成功地对它们执行操作

实现ICommand接口：

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方法。此命令只用到了Execute方法，实现这个方法时，将方法的参数作为命令的目标，如果目标是IView接口派生类，则调用Clear方法

通过实现ICommandSource接口创建自定义命令源：

 public class MyCommandSource : UserControl, ICommandSource
    {
        //继承自ICommandSource的三个属性
        public ICommand Command { get; set; }
        public object CommandParameter { get; set; }
        public IInputElement CommandTarget { get; set; }

        //组件被单击时连带执行命令
        protected override void OnPreviewMouseLeftButtonDown(MouseButtonEventArgs e)
        {
            base.OnPreviewMouseLeftButtonDown(e);
            //在命令目标上执行命令，或称让命令作用于命令目标
            if (this.CommandTarget != null)
            {
                this.Command.Execute(this.CommandTarget);
            }
        }
    }

ICommandSource接口包含Command、CommandParameter、CommandTarget三个属性。在此，CommandParameter没有用到，而CommandTarget被当做参数传递给了Command的Execute方法。

创建命令目标：因为ClearCommand命令作用于IView派生类，所以命令目标必须实现IView接口。为工程添加一个用户控件（UserControl）

XAML代码如下：

<UserControl x:Class="UserCommandTest.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"
             xmlns:local="clr-namespace:UserCommandTest"
             mc:Ignorable="d"
             d:DesignHeight="300" d:DesignWidth="300">
    <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>
</UserControl>

后台代码如下（此类需要继承自IView）：

//此类需要继承IView
    public partial class MiniView : UserControl,IView
    {
        public MiniView()
        {
            InitializeComponent();
        }

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

主窗体的XAML代码：

<Window x:Class="UserCommandTest.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:UserCommandTest"
        mc:Ignorable="d"
        Title="MainWindow" Height="350" Width="525">
    <Grid>
        <StackPanel>
            <local:MyCommandSource x:Name="ctrlClear" Margin="10">
                <TextBlock Text="清除" FontSize="16" TextAlignment="Center" Background="LightGreen" Width="80"/>
            </local:MyCommandSource>
            <local:MiniView x:Name="miniView"/>
        </StackPanel>
    </Grid>
</Window>

主窗体后台代码：

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

            ClearCommand clearCmd = new ClearCommand();
            this.ctrlClear.Command = clearCmd;
            this.ctrlClear.CommandTarget = this.miniView;
        }
    }

先创建一个ClearCommand命令实例，并赋值给自定义命令源的Command属性，自定义命令源的CommandTarget属性是自定义命令目标MiniView实例。

原文地址：https://www.cnblogs.com/mengjiulong/p/9800624.html

时间： 2024-08-05 00:47:26

WPF学习—命令

WPF学习—命令的相关文章

命令——WPF学习之深入浅出

【WPF学习】第三十二章执行命令

【WPF学习】第三十一章 WPF命令模型

WPF C# 命令学习

WPF学习07：MVVM 预备知识之数据绑定

WPF学习08：MVVM 预备知识之COMMAND

WPF学习11：基于MVVM Light 制作图形编辑工具（2）

【WPF学习】第二十章内容控件

WPF之命令浅谈