2.2 WPF 中的简单命令示例

在 WPF 中使用命令的最简单方法是从某个命令库类中使用预定义的 RoutedCommand；使用对处理此命令具有固有支持的控件；以及使用对调用命令具有固有支持的控件。

Paste 命令是ApplicationCommands 类中的预定义命令之一。 TextBox 控件具有处理 Paste 命令的内置逻辑。 MenuItem 类具有对调用命令的固有支持。下面的示例演示如何设置 MenuItem，以便单击该菜单项时，将对 TextBox 调用 Paste 命令（假定该 TextBox 具有键盘焦点）。

XAML

<StackPanel>

  <Menu>

    <MenuItem Command="ApplicationCommands.Paste" />

  </Menu>

  <TextBox />

</StackPanel>

C#

// Creating the UI objects

StackPanel mainStackPanel = new StackPanel();

TextBox pasteTextBox = new TextBox();

Menu stackPanelMenu = new Menu();

MenuItem pasteMenuItem = new MenuItem();

// Adding objects to the panel and the menu

stackPanelMenu.Items.Add(pasteMenuItem);

mainStackPanel.Children.Add(stackPanelMenu);

mainStackPanel.Children.Add(pasteTextBox);

// Setting the command to the Paste command

pasteMenuItem.Command = ApplicationCommands.Paste;

// Setting the command target to the TextBox

pasteMenuItem.CommandTarget = pasteTextBox;

如前述所述，WPF 中的命令是通过实现 ICommand 接口创建的。 ICommand 公开两个方法（Execute 及 CanExecute）和一个事件（CanExecuteChanged）。 Execute 执行与命令关联的操作。CanExecute 确定是否可以在当前命令目标上执行命令。 如果集中管理命令操作的命令管理器检测到命令源中发生了更改，此更改可能使得已引发但尚未由命令绑定执行的命令无效，则将引发 CanExecuteChanged。

RoutedCommand 上的 Execute 方法在命令目标上引发 PreviewExecuted 和 Executed 事件。 RoutedCommand 上的 CanExecute 方法在命令目标上引发 CanExecute 和PreviewCanExecute 事件。 这些事件沿元素树以隧道和冒泡形式传递，直到遇到具有该特定命令的 CommandBinding 的对象。

命令源是调用命令的对象。 例如，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 执行时调用命令。

2.3.2.1 举例： ContextMenu 中的 MenuItem 用作 Properties 命令的命令源

下面的示例演示如何将 ContextMenu 中的 MenuItem 用作 Properties 命令的命令源。

XAML

<StackPanel>

  <StackPanel.ContextMenu>

    <ContextMenu>

      <MenuItem Command="ApplicationCommands.Properties" />

    </ContextMenu>

  </StackPanel.ContextMenu>

</StackPanel>

C#

StackPanel cmdSourcePanel = new StackPanel();

ContextMenu cmdSourceContextMenu = new ContextMenu();

MenuItem cmdSourceMenuItem = new MenuItem();

// Add ContextMenu to the StackPanel.

cmdSourcePanel.ContextMenu = cmdSourceContextMenu;

cmdSourcePanel.ContextMenu.Items.Add(cmdSourceMenuItem);

// Associate Command with MenuItem.

cmdSourceMenuItem.Command = ApplicationCommands.Properties;

通常，命令源会侦听 CanExecuteChanged 事件。 此事件通知命令源，在当前命令目标上执行命令的能力可能已更改。 命令源可以通过使用 CanExecute 方法来查询 RoutedCommand 的当前状态。 之后，如果命令无法执行，则命令源可以禁用其自身。 这种情况的一个示例是：当无法执行命令时，MenuItem 会将自己显示为灰色。

2.3.2.2 举例： InputGesture 作命令源

可以将 InputGesture 用作命令源。 WPF 中两种类型的输入笔势是 KeyGesture 和 MouseGesture。 可以将 KeyGesture 视为键盘快捷方式，如 Ctrl+C。 KeyGesture 由一个 Key 和一组ModifierKeys 组成。 MouseGesture 由一个 MouseAction 和一组可选的 ModifierKeys 组成。

为了使 InputGesture 充当命令源，必须将它与一个命令关联。 有几种方法可实现此目的。 一种方法是使用 InputBinding。

下面的示例演示如何在 KeyGesture 与 RoutedCommand 之间创建一个 KeyBinding。

XAML

<Window.InputBindings>

  <KeyBinding Key="B"

              Modifiers="Control"

              Command="ApplicationCommands.Open" />

</Window.InputBindings>

C#

KeyGesture OpenKeyGesture = new KeyGesture(

    Key.B,

    ModifierKeys.Control);

KeyBinding OpenCmdKeybinding = new KeyBinding(

    ApplicationCommands.Open,

    OpenKeyGesture);

this.InputBindings.Add(OpenCmdKeybinding);

2.3.2.3  InputGesture 与 RoutedCommand 关联

将 InputGesture 与 RoutedCommand 关联的另一种方法是将 InputGesture 添加到 RoutedCommand 的 InputGestureCollection。

下面的示例演示如何将一个 KeyGesture 添加到 RoutedCommand 的 InputGestureCollection。