AddHandler ステートメント

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

更新 : 2007 年 11 月

実行時にイベントをイベントハンドラに関連付けます。

AddHandler event, AddressOf eventhandler

指定項目

event
処理するイベントの名前。
eventhandler
イベントを処理するプロシージャの名前。

解説

AddHandler ステートメントと RemoveHandler ステートメントを使うと、プログラムの実行中にいつでもイベント処理を開始および停止できます。

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

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

カスタムイベントの場合は、AddHandler ステートメントはイベントの AddHandler アクセサを呼び出します。カスタムイベントの詳細については、「Event ステートメント」を参照してください。

使用例

Sub TestEvents()
    Dim Obj As New Class1
    ' Associate an event handler with an event.
    AddHandler Obj.Ev_Event, AddressOf EventHandler
    ' Call the method to raise the event.
    Obj.CauseSomeEvent()
    ' Stop handling events.
    RemoveHandler Obj.Ev_Event, AddressOf EventHandler
    ' This event will not be handled.
    Obj.CauseSomeEvent()
End Sub

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

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