Visual Basic と WPF のイベント処理

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

Microsoft Visual Basic .NET 言語の場合に限り、言語固有の Handles キーワードを使用すると、イベントハンドラを、属性に関連付けたり AddHandler メソッドを使用したりする代わりに、インスタンスに関連付けることができます。ただし、ハンドラをインスタンスに関連付ける Handles 手法にはいくつかの制限もあります。Handles 構文でサポートできない WPF イベントシステムの特定のルーティングイベント機能が存在するためです。

WPF アプリケーションでの "ハンドル" の使用

Handles を使用してインスタンスおよびイベントに接続されるイベントハンドラは、すべてインスタンスの部分クラス宣言内で定義される必要があります。これは、要素の属性値を使用して割り当てられるイベントハンドラの要件でもあります。Handles は、Name プロパティ値を持つ (または x:Name 属性が宣言された) ページの要素に対してのみ指定できます。これは、XAML の Name によって、Handles 構文で必要な Instance.Event 参照形式をサポートするために必要なインスタンス参照が作成されるためです。Name 参照なしで Handles に使用できる要素は、部分クラスを定義するルート要素インスタンスだけです。

Handles の後の Instance.Event 参照をコンマで区切ることによって、1 つのハンドラを複数の要素に割り当てることができます。

Handles を使用して、複数のハンドラを 1 つの Instance.Event 参照に割り当てることができます。ハンドラが Handles 参照に指定される順序は重要ではありません。同じイベントを処理するハンドラはどのような順序でも呼び出せることを想定する必要があります。

宣言内で Handles を使用して追加されたハンドラを削除するには、RemoveHandler を呼び出します。

Handles を使用して、ルーティングイベントのハンドラをアタッチすることができます。ただしその場合には、メンバテーブルで処理されるイベントを定義するインスタンスにハンドラをアタッチする必要があります。ルーティングイベントの場合、Handles を使用してアタッチされるハンドラは、XAML 属性としてアタッチされるハンドラまたは AddHandler の一般的なシグネチャにアタッチされるハンドラの場合と同じルーティング規則に従います。つまり、イベントが既に処理済みとしてマークされている場合 (イベントデータの Handled プロパティが True の場合)、Handles を使用してアタッチされるハンドラは、そのイベントインスタンスに応答して呼び出されることはありません。イベントは、ルート内の別の要素のインスタンスハンドラによって処理済みとしてマークされるか、ルート上の現在の要素または前の要素のクラス処理によって処理済みとしてマークされます。トンネル/バブルのペアになったイベントをサポートする入力イベントの場合は、トンネルルートがイベントペアを処理済みとしてマークしていることがあります。ルーティングイベントの詳細については、「ルーティングイベントの概要」を参照してください。

ハンドラの追加時の "ハンドル" の制限

Handles は、添付イベントのハンドラを参照できません。その添付イベントの add アクセサメソッドを使用するか、XAML で typename.eventname イベント属性を使用する必要があります。詳細については、「ルーティングイベントの概要」を参照してください。

ルーティングイベントの場合、Handles を使用して、インスタンスメンバテーブルのそのイベントが存在するインスタンスにハンドラを割り当てることしかできません。ただし、ルーティングイベントでは通常、親要素を子要素のイベントのリスナにすることができます。これは、親要素のメンバテーブルにそのイベントが存在しない場合でも可能です。属性構文では、処理するイベントを実際に定義する型を修飾する typename.membername 属性形式を使用してこの指定を行うことができます。たとえば、Button.Click の形式で属性ハンドラを割り当てることで、(Click イベントが定義されていない) 親 Page がボタンクリックイベントをリッスンできるようになります。ただし、Handles は競合する Instance.Event 形式をサポートする必要があるため、typename.membername 形式をサポートしません。詳細については、「ルーティングイベントの概要」を参照してください。

Handles は、既に処理済みとしてマークされているイベントに対して呼び出されるハンドラをアタッチすることはできません。代わりに、コードを使用して AddHandler(RoutedEvent, Delegate, Boolean) の handledEventsToo オーバーロードを呼び出す必要があります。

WPF での "ハンドル" 機能の実装方法

Extensible Application Markup Language (XAML) ページのコンパイル時に、中間ファイルで、Name プロパティが設定されている (または x:Name 属性が宣言されている) ページのすべての要素への FriendWithEvents 参照が宣言されます。それぞれの名前付きインスタンスは、Handles を使用してハンドラに割り当てることができる要素になる可能性があります。

メモ :
Microsoft Visual Studio 内では、IntelliSense によって、要素がページの Handles 参照に使用できるようになったことを表示できます。ただし、これには、中間ファイルですべての Friends 参照を設定できるように、1 つのコンパイルパスが必要になる場合があります。