WPF のコマンドは、ICommand インターフェイスを実装することによって作成されます。ICommand は、Execute と CanExecute の 2 つのメソッドと CanExecuteChanged イベントを公開します。Execute はコマンドに関連するアクションを実行します。CanExecute は現在のコマンドの対象でコマンドを実行できるかどうかを決定します。CanExecuteChanged は、コマンド実行操作を集中管理するコマンド マネージャが、発生済みだがコマンド バインディングによってまだ実行されていないコマンドを無効にする可能性がある変更をコマンド ソース内で検出した場合に発生します。WPF での ICommand の実装は RoutedCommand クラスです。この概要ではこのクラスを中心に説明しています。

WPF の主な入力ソースは、マウス、キーボード、インク、およびルーティング コマンドです。よりデバイス指向の入力では、RoutedEvent を使用して、入力イベントが発生したアプリケーション ページ内のオブジェクトを通知します。RoutedCommand も同じです。RoutedCommand の Execute メソッドと CanExecute メソッドには、コマンドのアプリケーション ロジックは含まれませんが、CommandBinding を持つオブジェクトを検出するまで、要素ツリー内をトンネリングおよびバブリングするルーティング イベントを発生させます。CommandBinding にはこれらのイベントのハンドラが含まれ、このハンドラがコマンドを実行するハンドラとなります。WPF 内でのイベント ルーティングの詳細については、「ルーティング イベントの概要」を参照してください。

RoutedCommand の Execute メソッドは、コマンドの対象で PreviewExecuted イベントと Executed イベントを発生させます。RoutedCommand の CanExecute メソッドは、コマンドの対象で CanExecute イベントと PreviewCanExecute イベントを発生させます。これらのイベントは、その特定のコマンドの CommandBinding を持つオブジェクトを検出するまで、要素ツリー内をトンネリングおよびバブリングします。

WPF は、複数のクラスに散在する一連の一般的なルーティング コマンドである MediaCommands、ApplicationCommands、NavigationCommands、ComponentCommands、および EditingCommands を提供します。これらのクラスは、RoutedCommand オブジェクトのみで構成され、コマンドの実装ロジックは含まれません。実装ロジックは、コマンドが実行されているオブジェクトに含まれます。

コマンド ソースは、コマンドを呼び出すオブジェクトです。コマンド ソースには、MenuItem、Button、KeyGesture などがあります。

通常 WPF のコマンド ソースは、ICommandSource インターフェイスを実装します。

ICommandSource は、Command、CommandTarget、および CommandParameter の 3 つのプロパティを公開します。

• Command は、コマンド ソースが呼び出されると実行されるコマンドです。

• CommandTarget は、コマンドが実行される対象オブジェクトです。WPF では、ICommandSource の CommandTarget プロパティは、ICommand が RoutedCommand の場合にのみ適用されることに注意してください。ICommandSource で CommandTarget が設定されていても、対応するコマンドが RoutedCommand でない場合は、コマンドの対象は無視されます。CommandTarget が設定されていない場合は、キーボード フォーカスを持つ要素がコマンドの対象になります。

• CommandParameter は、コマンドを実装するハンドラに情報を渡すために使用されるユーザー定義のデータ型です。

ICommandSource を実装する WPF のクラスには、ButtonBase、MenuItem、Hyperlink、および InputBinding があります。ButtonBase、MenuItem、および Hyperlink は、クリックされるとコマンドを呼び出し、InputBinding は、それに関連付けられている InputGesture が実行されるとコマンドを呼び出します。

ContextMenu 内の MenuItem を、Properties コマンドのコマンド ソースとして使用する方法を次の例に示します。

<StackPanel>
  <StackPanel.ContextMenu>
    <ContextMenu>
      <MenuItem Command="ApplicationCommands.Properties" />
    </ContextMenu>
  </StackPanel.ContextMenu>
</StackPanel>

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 は、この一例です。

InputGesture は、コマンド ソースとして使用できます。WPF の入力ジェスチャには、KeyGesture と MouseGesture の 2 種類があります。KeyGesture は Ctrl + C などのキーボード ショートカットと考えることができます。KeyGesture は、Keyと、ModifierKeys のセットで構成されています。MouseGesture は、MouseAction と、オプションの ModifierKeys のセットで構成されています。

InputGesture をコマンド ソースとして機能させるには、コマンドに関連付ける必要があります。これを実現するには、いくつかの方法があります。1 つは、InputBinding を使用する方法です。

KeyGesture と RoutedCommand の間に KeyBinding を作成する方法を次の例に示します。

<Window.InputBindings>
  <KeyBinding Key="B"
              Modifiers="Control" 
              Command="ApplicationCommands.Open" />
</Window.InputBindings>

KeyGesture OpenKeyGesture = new KeyGesture(
    Key.B,
    ModifierKeys.Control);

KeyBinding OpenCmdKeybinding = new KeyBinding(
    ApplicationCommands.Open,
    OpenKeyGesture);

this.InputBindings.Add(OpenCmdKeybinding);

InputGesture を RoutedCommand に関連付ける別の方法は、InputGesture を RoutedCommand の InputGestureCollection に追加する方法です。

KeyGesture を RoutedCommand の InputGestureCollection に追加する方法を次の例に示します。

KeyGesture OpenCmdKeyGesture = new KeyGesture(
    Key.B,
    ModifierKeys.Control);

ApplicationCommands.Open.InputGestures.Add(OpenCmdKeyGesture);

CommandBinding は、コマンドを実装するイベント ハンドラにコマンドを関連付けます。

CommandBinding クラスには、Command プロパティと、PreviewExecuted、Executed、PreviewCanExecute、および CanExecute イベントが含まれます。

Command は、CommandBinding が関連付けられているコマンドです。PreviewExecuted イベントと Executed イベントに割り当てられたイベント ハンドラは、コマンド ロジックを実装します。PreviewCanExecute イベントと CanExecute イベントに割り当てられたイベント ハンドラは、コマンドが現在のコマンドの対象で実行可能かどうかを判断します。

アプリケーションのルート Window で CommandBinding を作成する方法を次の例に示します。CommandBinding は、Open コマンドを Executed ハンドラおよび CanExecute ハンドラに関連付けます。

<Window.CommandBindings>
  <CommandBinding Command="ApplicationCommands.Open"
                  Executed="OpenCmdExecuted"
                  CanExecute="OpenCmdCanExecute"/>
</Window.CommandBindings>

// Creating CommandBinding and attaching an Executed and CanExecute handler
CommandBinding OpenCmdBinding = new CommandBinding(
    ApplicationCommands.Open,
    OpenCmdExecuted,
    OpenCmdCanExecute);

this.CommandBindings.Add(OpenCmdBinding);

次に、ExecutedRoutedEventHandler および CanExecuteRoutedEventHandler を作成します。ExecutedRoutedEventHandler は、コマンドが実行されたことを知らせる文字列を表示する MessageBox を開きます。CanExecuteRoutedEventHandler は、CanExecute プロパティを true に設定します。

Private Sub OpenCmdExecuted(ByVal sender As Object, ByVal e As ExecutedRoutedEventArgs)
    Dim command, targetobj As String
    command = CType(e.Command, RoutedCommand).Name
    targetobj = CType(sender, FrameworkElement).Name
    MessageBox.Show("The " + command + " command has been invoked on target object " + targetobj)
End Sub

void OpenCmdExecuted(object target, ExecutedRoutedEventArgs e)
{
    String command, targetobj;
    command = ((RoutedCommand)e.Command).Name;
    targetobj = ((FrameworkElement)target).Name;
    MessageBox.Show("The " + command +  " command has been invoked on target object " + targetobj);
}

Private Sub OpenCmdCanExecute(ByVal sender As Object, ByVal e As CanExecuteRoutedEventArgs)
    e.CanExecute = True
End Sub

void OpenCmdCanExecute(object sender, CanExecuteRoutedEventArgs e)
{
    e.CanExecute = true;
}

CommandBinding は、アプリケーションまたはコントロールのルート Window などの特定のオブジェクトに割り当てられます。CommandBinding が割り当てられたオブジェクトは、バインディングのスコープを定義します。たとえば、コマンドの対象の先祖に割り当てられた CommandBinding には、Executed イベントによって到達できますが、コマンドの対象の子孫に割り当てられた CommandBinding には到達できません。これは、イベントを発生させるオブジェクトから RoutedEvent がトンネリングおよびバブリングするというしくみが直接影響するからです。

場合によっては、CommandBinding は、TextBox クラスに対する Cut、Copy、Paste の各コマンドのように、コマンドの対象自体に割り当てられます。ただし、CommandBinding は、特に同じ CommandBinding を複数のコマンドの対象で使用できる場合には、メイン Window やアプリケーション オブジェクトなど、コマンドの対象の先祖に割り当てる方が便利な場合がよくあります。これらは、コマンド実行インフラストラクチャの作成時に検討される設計上の決定事項です。

コマンドの対象は、コマンドが実行される要素です。RoutedCommand のコマンドの対象は、Executed および CanExecute のルーティングが開始される要素です。前に述べたように、WPF では、ICommandSource の CommandTarget プロパティは、ICommand が RoutedCommand の場合にのみ適用されます。ICommandSource で CommandTarget が設定されていても、対応するコマンドが RoutedCommand でない場合は、コマンドの対象は無視されます。

コマンド ソースは、コマンドの対象を明示的に設定できます。コマンドの対象が定義されていない場合は、キーボード フォーカスを持つ要素がコマンドの対象として使用されます。キーボード フォーカスを持つ要素をコマンドの対象として使用する利点の 1 つは、アプリケーション開発者が同じコマンド ソースを使用して、コマンドの対象を追跡せずにコマンドを複数の対象で呼び出すことができることです。たとえば、MenuItem が TextBox コントロールと PasswordBox コントロールを持つアプリケーションで [貼り付け] コマンドを呼び出した場合、その対象は、キーボード フォーカスのあるコントロールに応じて TextBox または PasswordBox にすることができます。

マークアップと分離コードでコマンドの対象を明示的に設定する方法を次の例に示します。

<StackPanel>
  <Menu>
    <MenuItem Command="ApplicationCommands.Paste"
              CommandTarget="{Binding ElementName=mainTextBox}" />
  </Menu>
  <TextBox Name="mainTextBox"/>
</StackPanel>

// 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;

CommandManager は、多数のコマンド関連機能を提供します。PreviewExecuted、Executed、PreviewCanExecute、および CanExecute の各イベント ハンドラを特定の要素に対して追加および削除するための一連の静的メソッドを提供します。CommandBinding オブジェクトと InputBinding オブジェクトを特定のクラスに登録する手段を提供します。また、CommandManager は、RequerySuggested イベントを介して、CanExecuteChanged イベントを発生させるタイミングをコマンドに通知する方法も提供します。

InvalidateRequerySuggested メソッドは、CommandManager に RequerySuggested イベントを強制的に発生させます。これは、コマンドを無効または有効にする必要がある場合に役立ちますが、CommandManager が認識しない場合には使用しません。InvalidateRequerySuggested を呼び出すことによって、CommandManager に RequerySuggested イベントを強制的に発生させる例については、「ディスパッチャのタイマによるコマンド ソースの無効化のサンプル」を参照してください。