次の方法で共有


Handles 句 (Visual Basic)

プロシージャが特定のイベントを処理することを宣言します。

proceduredeclaration Handles eventlist

指定項目

  • proceduredeclaration
    イベントを処理するプロシージャの Sub プロシージャ宣言。

  • eventlist
    proceduredeclaration が処理するイベントの、コンマ区切りのリストです。現在のクラスに対する基本クラス、または WithEvents キーワードを使って宣言されているオブジェクトのどちらかが発生させるイベントを指定する必要があります。

解説

プロシージャ宣言の末尾にキーワード Handles を指定すると、そのプロシージャは、キーワード WithEvents を使って宣言されたオブジェクト変数が発生させるイベントを処理します。Handles キーワードは、基本クラスからのイベントを処理するために派生クラスで使用することもできます。

プロシージャのシグネチャは、eventlist の各イベントのシグネチャと一致している必要があります。

Handles キーワードと AddHandler ステートメントは、どちらも特定のイベントを特定のプロシージャで処理するよう指定する方法ですが、いくつか相違点があります。特定のイベントを処理するプロシージャを定義するときには、Handles キーワードを使用します。AddHandler ステートメントは、実行時にイベントをプロシージャに関連付けます。詳細については、「AddHandler ステートメント」を参照してください。

カスタム イベントの場合は、プロシージャがイベント ハンドラーとして追加されたときに、アプリケーションがイベントの AddHandler アクセサーを呼び出します。カスタム イベントの詳細については、「Event ステートメント」を参照してください。

使用例

Public Class ContainerClass
    ' Module or class level declaration.
    WithEvents Obj As New Class1

    Public Class Class1
        ' Declare an event.
        Public Event Ev_Event()
        Sub CauseSomeEvent()
            ' Raise an event.
            RaiseEvent Ev_Event()
        End Sub
    End Class

    Sub EventHandler() Handles Obj.Ev_Event
        ' Handle the event.
        MsgBox("EventHandler caught event.")
    End Sub

    ' Call the TestEvents procedure from an instance of the ContainerClass 
    ' class to test the Ev_Event event and the event handler.
    Public Sub TestEvents()
        Obj.CauseSomeEvent()
    End Sub
End Class

次に示すのは、派生クラスで Handles ステートメントを使って基本クラスからのイベントを処理する方法の例です。

Public Class BaseClass
    ' Declare an event.
    Event Ev1()
End Class
Class DerivedClass
    Inherits BaseClass
    Sub TestEvents() Handles MyBase.Ev1
        ' Add code to handle this event.
    End Sub
End Class

[WPF アプリケーション] プロジェクトに対する、2 つのボタンのイベント ハンドラーの例を次に示します。

Private Sub Button1_Click(sender As System.Object, e As System.Windows.RoutedEventArgs) Handles Button1.Click
    MessageBox.Show(sender.Name & " clicked")
End Sub

Private Sub Button2_Click(sender As System.Object, e As System.Windows.RoutedEventArgs) Handles Button2.Click
    MessageBox.Show(sender.Name & " clicked")
End Sub

次の例は、上の例と同じ意味になります。Handles 句の eventlist には、2つのボタンに対するイベントが含まれています。

Private Sub Button_Click(sender As System.Object, e As System.Windows.RoutedEventArgs) Handles Button1.Click, Button2.Click
    MessageBox.Show(sender.Name & " clicked")
End Sub

参照

関連項目

WithEvents (Visual Basic)

AddHandler ステートメント

RemoveHandler ステートメント

Event ステートメント

RaiseEvent ステートメント

その他の技術情報

イベント (Visual Basic)