命令系统的基本元素和关系
WPF命令系统的组成要素:
A.命令(command):WPF命令实际上就是实习了ICommand接口的类。平时使用最多的就是RoutedCommand类。
B.命令源(command source):即命令的发送者,实现了ICommandSource接口的类。
C.命令目标(command Target):即命令发给了谁或理解为命令的接收者。命令目标必须是实现了IInputElement接口的类。
D.命令关联(command Binding):负责把一些外围逻辑和命令关联起来。比如执行之前对命令是否可以执行进行判、命令执行之后还有哪些后续工作等。
命令使用的步骤:
1.创建命令类
2.声明命名实例
3.指定命令源
4.指定命令目标
5.设置命令关联
ICommand接口与RoutedCommand
WPF中的命令是实现了ICommand接口的类。
ICommand接口非常简单,只包含两个方法一个事件。
<1>Execute方法:命令执行,或者说命令执行于命令目标之上。需要注意的是,现实世界中的命令是不会自己执行的,而这里,执行变成了命令的方法,有点拟人化的味道。
<2>CanExecute方法:在执行之前探知命令是否可以执行。
<3>CanExecuteChanged事件:当命令的可执行状态改变的时候,可激发此事件通知其它对象。
RoutedCommand就是一个实现了ICommand接口的类。
RoutedCommand在实现ICommand接口时,并未向Execute和CanExecute方法中添加任何逻辑,
也就是说,它是通用的、与具体的业务逻辑无关的。
<Window x:Class="命令1.MainWindow" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" Title="MainWindow" Height="350" Width="525"> <StackPanel Background="Red" x:Name="sp1"> <Button x:Name="btn1" Content="Send Clear Command" Margin="5" Background="{Binding}"/> <TextBox x:Name="txtA" Margin="5,0" Height="200"/> </StackPanel> </Window>
using System.Windows;
using System.Windows.Input;
namespace 命令1
{
/// <summary>
/// MainWindow.xaml 的交互逻辑
/// </summary>
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent();
InitializeCommand();
}
//1.创建命令类
//2.声明命名实例
//3.指定命令源—— 命令发送者
//4.指定命令目标——命令接收者
//5.设置命令关联
//声明并定义命令
private RoutedCommand RouutedCommand = new RoutedCommand("可输入非空字符", typeof(MainWindow));
private void InitializeCommand()
{
//把命令赋值给命令源,并定义快捷键
this.btn1.Command = RouutedCommand;
this.RouutedCommand.InputGestures.Add(new KeyGesture(Key.C, ModifierKeys.Alt));
//指定命令目标
this.btn1.CommandTarget = txtA;
//创建命令关联
CommandBinding commandBinding = new CommandBinding();
commandBinding.Command = RouutedCommand;//只关注与rouutedCommand相关的命令
commandBinding.CanExecute += new CanExecuteRoutedEventHandler(cb_CanExecute);
commandBinding.Executed += new ExecutedRoutedEventHandler(cb_Execute);
//把命令关联安置在外围控件上
this.sp1.CommandBindings.Add(commandBinding);
}
//当命令到达目标之后,此方法被调用
private void cb_Execute(object sender, ExecutedRoutedEventArgs e)
{
this.txtA.Clear();
//避免事件继续向上传递而降低程序性能
e.Handled = true;
}
//当探测命令是否可执行的时候该方法会被调用
private void cb_CanExecute(object sender, CanExecuteRoutedEventArgs e)
{
if (string.IsNullOrEmpty(txtA.Text))
{
e.CanExecute = false;
}
else
{
e.CanExecute = true;
}
//避免事件继续向上传递而降低程序性能
e.Handled = true;
}
}
}
//对于以上的代码,需要注意以下几点:
//第一,使用命令可以避免自己写代码判断Button是否可以用以及添加快捷键。
//第二,RountedCommand是一个与业务逻辑无关的类,只负责在程序中跑腿而并不对命令目标进行操作,
//TextBox并不是由它清空的。那么TextBox的情况操作是谁呢?答案是CommandBinding。
//因为无论是探测命令是否可以执行还是命令送达目标,都会激发命令目标发送路由事件,
//这些事件会沿着UI元素树向上传递,最终被CommandBinding所捕捉。
//本例中CommandBinding被安装在外围的StackPanel上,Commandbinding站在高处起一个侦听器的作用,
//而且专门针对rouutedCommand命令捕捉与其相关的事件。
//本例中,当CommandBinding捕捉到CanExecute就会调用cb_CanExecute方法。
//当捕捉到是Executed的时候,就调用cb_Execute事件。
//第三,因为CanExecute事件的激发频率比较高,为了避免降低性能,在处理完毕之后建议将e.Handle设置为true。
//第四,CommandBinding一定要设置在命令目标的外围控件上,不然无法捕捉CanExecute和Executed等路由事件。
实例二:
<Window x:Class="命令2.MainWindow" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" Title="MainWindow" Height="350" Width="525"> <Grid> <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 HorizontalAlignment="Left" Name="textBlock1" Text="Name:" VerticalAlignment="Center" Grid.Row="0"/> <TextBox x:Name="txtName" Margin="60,5,0,0" Grid.Row="0"/> <Button Content="New Teacher" Grid.Row="2" Command="New" CommandParameter="Teacher"/> <Button Content="New Student" Grid.Row="4" Command="New" CommandParameter="Student"/> <ListBox Grid.Row="6" x:Name="lbInfos"/> </Grid> <!--为窗体添加CommandBinding--> <Window.CommandBindings> <CommandBinding Command="New" CanExecute="CommandBinding_CanExecute" Executed="CommandBinding_Executed"/> </Window.CommandBindings> </Window>
using System.Windows;
using System.Windows.Input;
namespace 命令2
{
/// <summary>
/// MainWindow.xaml 的交互逻辑
/// </summary>
public partial class MainWindow : Window
{
//两个按钮都使用的是New命令,但分别使用的是Student和Teacher做为的参数。
public MainWindow()
{
InitializeComponent();
}
/// <summary>
/// 当探测命令是否可执行的时候该方法会被调用
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void CommandBinding_CanExecute(object sender, CanExecuteRoutedEventArgs e)
{
if (string.IsNullOrEmpty(txtName.Text))
{
e.CanExecute = false;
}
else
{
e.CanExecute = true;
}
//路由终止,提高系统性能
e.Handled = true;
}
/// <summary>
/// 当命令到达目标之后,此方法被调用
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void CommandBinding_Executed(object sender, ExecutedRoutedEventArgs e)
{
if (e.Parameter.ToString() == "Student")
{
this.lbInfos.Items.Add(string.Format("New Student:{0} 好好学习,天天向上。", txtName.Text));
}
else if (e.Parameter.ToString() == "Teacher")
{
this.lbInfos.Items.Add(string.Format("New Teacher:{0} 学而不厌,诲人不倦。", txtName.Text));
}
//路由终止,提高系统性能
e.Handled = true;
}
}
}
实例三:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
namespace 命令4
{
public interface IView
{
//属性
bool IsChanged { get; set; }
//方法
void SetBinding();
void Refresh();
void Clear();
void Save();
}
}
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Windows.Input;
namespace 命令4
{
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();
}
}
}
}
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Windows.Controls;
using System.Windows.Input;
using System.Windows;
namespace 命令4
{
public class MyCommandSource : UserControl, ICommandSource
{
/// <summary>
/// 继承自ICommand的3个属性
/// </summary>
public ICommand Command
{
get;
set;
}
public object CommandParameter
{
get;
set;
}
public IInputElement CommandTarget
{
get;
set;
}
//在命令目标上执行命令,或者说让命令作用于命令目标
protected override void OnMouseLeftButtonDown(MouseButtonEventArgs e)
{
base.OnMouseLeftButtonDown(e);
if (this.CommandTarget != null)
{
this.Command.Execute(CommandTarget);
}
}
}
}
<UserControl x:Class="命令4.UCMniView" 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="300" d:DesignWidth="300"> <Border CornerRadius="5" BorderBrush="GreenYellow" BorderThickness="2"> <StackPanel> <TextBox Margin="5" x:Name="txt1"></TextBox> <TextBox Margin="5" x:Name="txt2"></TextBox> <TextBox Margin="5" x:Name="txt3"></TextBox> <TextBox Margin="5" x:Name="txt4"></TextBox> </StackPanel> </Border> </UserControl>
using System;
using System.Windows.Controls;
namespace 命令4
{
/// <summary>
/// UserControl.xaml 的交互逻辑
/// </summary>
public partial class UCMniView : UserControl,IView
{
public UCMniView()
{
InitializeComponent();
}
public bool IsChanged
{
get
{
throw new NotImplementedException();
}
set
{
throw new NotImplementedException();
}
}
public void SetBinding()
{
throw new NotImplementedException();
}
public void Refresh()
{
throw new NotImplementedException();
}
public void Clear()
{
this.txt1.Clear();
this.txt2.Clear();
this.txt3.Clear();
this.txt4.Clear();
}
public void Save()
{
throw new NotImplementedException();
}
}
}
<Window x:Class="命令4.MainWindow" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:local="clr-namespace:命令4" Title="MainWindow" Height="350" Width="525"> <StackPanel> <local:MyCommandSource x:Name="myCommandSource1"> <TextBlock Text="清除" Width="80" FontSize="16" TextAlignment="Center" Background="LightGreen"/> </local:MyCommandSource> <local:UCMniView x:Name="mniView1" /> </StackPanel> </Window>
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
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 命令4
{
/// <summary>
/// MainWindow.xaml 的交互逻辑
/// </summary>
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent();
ClearCommand clearCommand = new ClearCommand();
this.myCommandSource1.Command = clearCommand;
this.myCommandSource1.CommandTarget = mniView1;
}
}
}