ToolStripControlHost.OnSubscribeControlEvents(Control) Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Sottoscrive gli eventi dal controllo ospitato.

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)

Parametri

control

Control

Controllo da cui sottoscrivere eventi.

Esempio

Nell'esempio di codice seguente viene illustrato come configurare la gestione degli eventi per un evento esposto dal controllo ospitato. Questo esempio di codice fa parte di un esempio più ampio fornito per la ToolStripControlHost classe .

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

Commenti

Eseguire l'override del OnSubscribeControlEvents metodo per aggiungere o impedire la sincronizzazione degli eventi di controllo.

Se si esegue l'override e si associano gli eventi in questo caso, annullarne ilhook usando il OnUnsubscribeControlEvents metodo .

Quando viene generato un evento, il gestore dell'evento viene richiamato tramite un delegato. Per altre informazioni, vedere la gestione e generazione di eventi.

Il metodo OnSubscribeControlEvents consente inoltre alle classi derivate di gestire l'evento senza associare un delegato. È la tecnica consigliata per la gestione dell'evento in una classe derivata.

Note per gli eredi

Quando si esegue l'override di OnSubscribeControlEvents(Control) in una classe derivata, verificare di chiamare il metodo OnSubscribeControlEvents(Control) della classe di base in modo che i delegati registrati ricevano l'evento.