ToolStripControlHost.OnSubscribeControlEvents メソッド

.NET Framework クラス ライブラリ リファレンス

ToolStripControlHost.OnSubscribeControlEvents メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ホストされるコントロールからイベントをサブスクライブします。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Sub
 OnSubscribeControlEvents ( _
    control As Control _
)

Visual Basic (使用法)

Dim control As Control

Me.OnSubscribeControlEvents(control)

C#

protected virtual void OnSubscribeControlEvents
 (
    Control control
)

C++

protected:
virtual void OnSubscribeControlEvents (
    Control^ control
)

J#

protected void OnSubscribeControlEvents (
    Control control
)

JScript

protected function OnSubscribeControlEvents
 (
    control : Control
)

パラメータ

control

イベントをサブスクライブするコントロール。

解説

OnSubscribeControlEvents メソッドをオーバーライドすることにより、コントロールのイベントの同期化を実行または抑制できます。

イベントをオーバーライドしてフックする場合、OnUnSubscribeControlEvents メソッドを使用して、それらをアンフックします。

イベントが発生すると、デリゲートを使用してイベント ハンドラが呼び出されます。詳細については、「イベントの発生」を参照してください。

OnSubscribeControlEvents メソッドを使用すると、デリゲートを結び付けずに、派生クラスでイベントを処理することもできます。派生クラスでイベントを処理する場合は、この手法をお勧めします。

継承時の注意 派生クラスで OnSubscribeControlEvents をオーバーライドする場合は、登録されているデリゲートがイベントを受け取ることができるように、基本クラスの OnSubscribeControlEvents メソッドを呼び出してください。

使用例

ホストされるコントロールが公開するイベントのイベント処理を設定する方法を次のコード例に示します。このコード例は、ToolStripControlHost クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Protected Overrides Sub
 OnSubscribeControlEvents(ByVal c As Control)
 

    ' Call the base so the base events are connected.
    MyBase.OnSubscribeControlEvents(c)
    
    ' Cast the control to a MonthCalendar control.
    Dim monthCalendarControl As MonthCalendar
 = _
        CType(c, MonthCalendar)

    ' Add the event.
    AddHandler monthCalendarControl.DateChanged, _
        AddressOf HandleDateChanged

End Sub

C#

protected override void OnSubscribeControlEvents(Control
 c)
{
    // Call the base so the base events are connected.
    base.OnSubscribeControlEvents(c);

    // Cast the control to a MonthCalendar control.
    MonthCalendar monthCalendarControl = (MonthCalendar) c;

    // Add the event.
    monthCalendarControl.DateChanged +=
        new DateRangeEventHandler(OnDateChanged);
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ToolStripControlHost クラス
ToolStripControlHost メンバ
System.Windows.Forms 名前空間