ExecutedRoutedEventHandler 代理人

定義

名前空間:

System.Windows.Input

アセンブリ:

PresentationCore.dll

Executed と PreviewExecuted のルーティング イベントだけでなく、関連する添付イベントも処理するメソッドを表します。

C#

public delegate void ExecutedRoutedEventHandler(object sender, ExecutedRoutedEventArgs e);

パラメーター

sender

Object

イベント ハンドラーがアタッチされているオブジェクト。

e

ExecutedRoutedEventArgs

イベントのデータ。

例

次の使用例は、 ExecutedRoutedEventHandler コマンドの実行時にターゲットにビジュアル プロパティを設定する を作成します。 この例には、同じコマンドの も CanExecuteRoutedEventHandler 含まれています。

C#

// ExecutedRoutedEventHandler for the custom color command.
private void ColorCmdExecuted(object sender, ExecutedRoutedEventArgs e)
{
    Panel target = e.Source as Panel;
    if (target != null)
    {
        if (target.Background == Brushes.AliceBlue)
        {
            target.Background = Brushes.LemonChiffon;
        }
        else
        {
            target.Background = Brushes.AliceBlue;
        }
    }
}

// CanExecuteRoutedEventHandler for the custom color command.
private void ColorCmdCanExecute(object sender, CanExecuteRoutedEventArgs e)
{
    if (e.Source is Panel)
    {
        e.CanExecute = true;
    }
    else
    {
        e.CanExecute = false;
    }
}

注釈

このデリゲートには、 の実装ロジックが RoutedCommand含まれています。 実装ロジックをコマンドから分離すると、コマンドをさまざまなソースと型から呼び出し、コマンド ロジックを一元化できます。

このデリゲートは、 と CommandManager.PreviewExecutedにも使用CommandManager.Executedされます。これは、コマンド インフラストラクチャの多くをCommandManager実装するクラスにイベントがアタッチされています。 ただし、ほとんどの実用的なハンドラーは、レベルで動作するのではなく、特定CommandBindingの からのイベントをCommandManager処理Executedします。

内では ExecutedRoutedEventArgs、一般に、実行されたコマンドから発生するルーティング イベントのイベント ハンドラーを記述する場合、次のプロパティが重要です。

• Source は、コマンドが実行されたターゲットを報告します。 コマンドが実行されると、ルーティング イベントの Source 用語で一般的に、ルーティング イベントを発生させたオブジェクトと考えることもできます。

• Command は、実行されたコマンドを報告します。 このプロパティは、コマンド バインドを使用する場合や、複数のコマンドを処理する可能性があるハンドラーを記述する場合に便利です。

• Parameter は、実行中のコマンドによって渡されたコマンド固有のパラメーターを報告します。 すべてのコマンドでコマンド固有のパラメーターが使用または予期されるわけではありません。

• Handled は、実行されたコマンドから発生したルーティング イベントが、ルートに沿って別の要素によって既に処理されたかどうかを報告します。 ルーティング イベント ハンドラーの場合は、 に設定Handledtrueするイベントを処理するときに意味のある作業を行うハンドラーを用意することをお勧めします。 これにより、イベントの一般的なハンドラーがルートに沿ってイベントを再び処理できなくなります。 ルーティング イベントの処理の詳細については、「ルーティング イベントを 処理済みとしてマークする」および「クラス処理」を参照してください。

このデリゲートは、 および CommandManager.PreviewExecutedEventのハンドラーCommandManager.Executedも表します。これは、コマンド インフラストラクチャの多くをCommandManager実装する クラスにアタッチされたイベントです。 ただし、ほとんどの実用的なハンドラーは、レベルで動作するのではなく、特定CommandBindingの からのイベントをCommandManager処理Executedします。

コマンド実行の詳細については、「コマンド実行の概要」を参照してください。

拡張メソッド

適用対象

こちらもご覧ください

• CommandBinding
• ExecutedRoutedEventArgs