ToolStripControlHost.OnSubscribeControlEvents(Control) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Abonniert Ereignisse vom gehosteten Steuerelement.

protected:
 virtual void OnSubscribeControlEvents(System::Windows::Forms::Control ^ control);

protected virtual void OnSubscribeControlEvents (System.Windows.Forms.Control? control);

abstract member OnSubscribeControlEvents : System.Windows.Forms.Control -> unit
override this.OnSubscribeControlEvents : System.Windows.Forms.Control -> unit

Protected Overridable Sub OnSubscribeControlEvents (control As Control)

Parameter

control

Control

Das Steuerelement, von dem Ereignisse abonniert werden sollen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Ereignisbehandlung für ein Ereignis einrichten, das vom gehosteten Steuerelement verfügbar gemacht wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ToolStripControlHost-Klasse bereitgestellt wird.

void OnSubscribeControlEvents( System::Windows::Forms::Control^ c )
{
   // Call the base so the base events are connected.
   __super::OnSubscribeControlEvents( c );
   
   // Cast the control to a MonthCalendar control.
   MonthCalendar^ monthCalendarControl = (MonthCalendar^)c;
   
   // Add the event.
   monthCalendarControl->DateChanged += gcnew DateRangeEventHandler( this, &ToolStripMonthCalendar::HandleDateChanged );
}

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);
}

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

Hinweise

Überschreiben Sie die OnSubscribeControlEvents -Methode, um die Synchronisierung von Steuerelementereignissen hinzuzufügen oder zu verhindern.

Wenn Sie Ereignisse hier überschreiben und einbinden, heben Sie sie mit der -Methode auf OnUnsubscribeControlEvents .

Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.

Mit der OnSubscribeControlEvents-Methode können auch abgeleitete Klassen das Ereignis ohne Anfügen eines Delegaten behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Vererber

Wenn Sie OnSubscribeControlEvents(Control) in einer abgeleiteten Klasse überschreiben, müssen Sie die OnSubscribeControlEvents(Control)-Methode der Basisklasse aufrufen, damit registrierte Delegaten das Ereignis empfangen.