WPF and Silverlight 学习笔记（十五）：WPF命令(Commands)
WPF中的命令路由与事件路由是两个很让初学者头痛的概念，对于命令路由可以理解为，系统（WPF）定义了一系列的操作，在应用程序中可以直接使用。例如，定义一系列菜单，执行对窗体中文本框的复制、剪切、粘贴操作，简单地可以这样做：
1: <Grid>
2: <Grid.RowDefinitions>
3: <RowDefinition Height="23" />
4: <RowDefinition />
5: </Grid.RowDefinitions>
6: <Menu Grid.Row="0" Grid.Column="0">
7: <MenuItem Header="Edit">
8: <MenuItem x:Name="menuCopy" Header="Copy"
9: Command="ApplicationCommands.Copy" />
10: <MenuItem x:Name="menuCut" Header="Cut"
11: Command="ApplicationCommands.Cut" />
12: <MenuItem x:Name="menuPaste" Header="Paste"
13: Command="ApplicationCommands.Paste" />
14: </MenuItem>
15: </Menu>
16: <TextBox Grid.Row="1" Grid.Column="0" x:Name="mainText"
17: TextWrapping="Wrap" AcceptsReturn="True" />
18: </Grid>
WPF 中的路由命令模型可以分为四个主要概念：命令、命令源、命令目标以及命令绑定：
-
命令是要执行的操作。在本例中命令为ApplicationCommands.Copy、Cut、Paste
-
命令源是调用命令的对象。 在本例中命令源为三个MenuItem控件
-
命令目标是在其上执行命令的对象。 在本例中命令目标是mainText这个TextBox文本框
-
命令绑定是将命令逻辑映射到命令的对象。 在本例中命令绑定到系统定义的对于文本框的“复制”、“剪切”、“粘贴”操作、
其四者的关系如下图所示：
一、命令：
WPF 中的命令是通过实现 ICommand 接口来创建的。ICommand 公开两个方法（Execute 和 CanExecute）和一个事件 (CanExecuteChanged)。Execute 执行与命令关联的操作。CanExecute 确定是否可以在当前命令目标上执行命令。如果集中管理命令操作的命令管理器检测到命令源中发生了更改，此更改可能使得已引发但尚未由命令绑定执行的命令无效，则将引发 CanExecuteChanged。ICommand 的 WPF 实现是 RoutedCommand 类。
RoutedCommand 上的 Execute 方法在命令目标上引发 PreviewExecuted 和 Executed 事件。RoutedCommand 上的 CanExecute 方法在命令目标上引发 CanExecute 和 PreviewCanExecute 事件。这些事件沿元素树以隧道和冒泡形式传递，直到遇到具有该特定命令的 CommandBinding 的对象。
WPF 提供了一组常用的路由命令，这组命令分布在几个类中：MediaCommands、ApplicationCommands、NavigationCommands、ComponentCommands 和 EditingCommands。这些类仅包含 RoutedCommand 对象，而不包含命令的实现逻辑。实现逻辑由在其上执行命令的对象负责。
WPF已封装的命令类有：
|
命令类 |
示例命令 |
|
ApplicationCommands |
Close、Cut、Copy、Paste、Save、Print |
|
NavigationCommands |
BrowseForward、BrowseBack、Zoom、Search |
|
EditingCommands |
AlignXXX、MoveXXX、SelectXXX |
|
MediaCommands |
Play、Pause、NextTrack、IncreaseVolume、Record、Stop |
|
ComponentCommands |
MoveXXX、SelectXXX、ScrollXXX、ExtendSelectionXXX |
二、命令源
命令源是调用命令的对象。例如，MenuItem、Button 和 KeyGesture 就是命令源。
WPF 中的命令源通常实现 ICommandSource 接口。
ICommandSource 公开三个属性：Command、CommandTarget 和 CommandParameter：
-
Command 是在调用命令源时执行的命令。
-
CommandTarget 是要在其上执行命令的对象。值得注意的是，在 WPF 中，ICommandSource 上的 CommandTarget 属性只有在 ICommand 是 RoutedCommand 时才适用。如果在 ICommandSource 上设置了 CommandTarget，而对应的命令不是 RoutedCommand，将会忽略命令目标。如果未设置 CommandTarget，则具有键盘焦点的元素将是命令目标。
-
CommandParameter 是用户定义的数据类型，用于将信息传递到实现命令的处理程序。
实现 ICommandSource 的 WPF 类包括：ButtonBase、MenuItem、Hyperlink 以及 InputBinding。ButtonBase、MenuItem 和 Hyperlink 在被单击时调用命令，InputBinding 在与之关联的 InputGesture 执行时调用命令。
ButtonBase等直接使用控件的Command属性绑定命令：
1: <Button Command="ApplicationCommands.Copy" />
而InputBinding使用KeyBinding或MouseBinding绑定特定的输入手势到某一命令上：
例如在Window上注册Ctrl+F2快捷键到ApplicationCommands.Open上：
三、命令目标
命令目标是在其上执行命令的元素。对于 RoutedCommand 而言，命令目标是 Executed 和 CanExecute 的路由的起始元素。前面已提到，在 WPF 中，ICommandSource 上的 CommandTarget 属性只有在 ICommand 是一个 RoutedCommand 时才适用。如果在 ICommandSource 上设置了 CommandTarget，而对应的命令不是 RoutedCommand，将会忽略命令目标。
命令源可以显式设置命令目标。如果未定义命令目标，则具有键盘焦点的元素将用作命令目标。将具有键盘焦点的元素用作命令目标的一个好处是，应用程序开发人员可以使用同一个命令源在多个目标上调用命令，而不必跟踪命令目标。例如，如果 MenuItem 在具有一个 TextBox 控件和一个 PasswordBox 控件的应用程序中调用“粘贴”命令，则目标既可以是 TextBox，也可以是 PasswordBox，具体取决于哪个控件具有键盘焦点。
如将Paste命令设置到mainText控件上：
1: <MenuItem x:Name="menuPaste" Header="Paste"
2: Command="ApplicationCommands.Paste"
3: CommandTarget="{Binding ElementName=txtMain}"/>
四、命令绑定
CommandBinding 将一个命令与实现该命令的事件处理程序关联。
CommandBinding 类包含一个 Command 属性以及 PreviewExecuted、Executed、PreviewCanExecute 和 CanExecute 事件。
Command 是 CommandBinding 要与之关联的命令。附加到 PreviewExecuted 和 Executed 事件的事件处理程序实现命令逻辑。附加到 PreviewCanExecute 和 CanExecute 事件的事件处理程序确定命令是否可以在当前命令目标上执行。
- CanExecute事件和PreviewCanExecute事件，通过其EventArgs参数中的CanExecute属性，设置其命令是否可以执行，并且系统会自动的和命令目标的某些特定属性进行绑定，例如Button、MenuItem等在CanExecute属性的值设为False时，会“灰化”，不可用
- Executed事件和PreviewExecuted事件的代码，是执行命令的真正代码。
例如，将ApplicationCommans.Save绑定到菜单栏的Save菜单项中，并在文本框中没有任何文本时不可用：
1: <Window x:Class="InputCommandAndFocus.WinCommandDemo"
2: xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
3: xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
4: Title="WinCommandDemo" Height="300" Width="300" Focusable="True">
5: <Window.InputBindings>
6: <KeyBinding Command="ApplicationCommands.Save"
7: Key="F3" Modifiers="Control" />
8: </Window.InputBindings>
9: <Window.CommandBindings>
10: <CommandBinding Command="ApplicationCommands.Save"
11: CanExecute="CommandBinding_Save_CanExecute"
12: Executed="CommandBinding_Save_Executed" />
13: </Window.CommandBindings>
14: <Grid>
15: <Grid.RowDefinitions>
16: <RowDefinition Height="23" />
17: <RowDefinition />
18: </Grid.RowDefinitions>
19: <Menu Grid.Row="0" Grid.Column="0">
20: <MenuItem Header="File">
21: <MenuItem x:Name="menuSave" Header="Save"
22: Command="ApplicationCommands.Save" />
23: </MenuItem>
24: </Menu>
25: <TextBox Grid.Row="1" Grid.Column="0" x:Name="mainText"
26: TextWrapping="Wrap" AcceptsReturn="True" />
27: </Grid>
28: </Window>
1: private void CommandBinding_Save_CanExecute(object sender, CanExecuteRoutedEventArgs e)
2: {
3: if (mainText.Text == string.Empty)
4: {
5: // 如果文本框中没有任何文本，则不可以保存
6: e.CanExecute = false;
7: }
8: else
9: {
10: e.CanExecute = true;
11: }
12: }
13:
14: private void CommandBinding_Save_Executed(object sender, ExecutedRoutedEventArgs e)
15: {
16: // 保存文件对话框
17: SaveFileDialog save = new SaveFileDialog();
18: save.Filter = "文本文件|*.txt|所有文件|*.*";
19:
20: bool? result = save.ShowDialog();
21: if (result.Value)
22: {
23: // 执行保存文件操作
24: }
25: }
