ToolStripControlHost.OnSubscribeControlEvents(Control) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Assina eventos do controle hospedado.

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)

Parâmetros

control

Control

O controle com base no qual assinar eventos.

Exemplos

O exemplo de código a seguir demonstra como configurar o tratamento de eventos para um evento exposto pelo controle hospedado. Este exemplo de código faz parte de um exemplo maior fornecido para a 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

Comentários

Substitua o OnSubscribeControlEvents método para adicionar ou impedir a sincronização de eventos de controle.

Se você substituir e conectar eventos aqui, desapare-os usando o OnUnsubscribeControlEvents método.

A geração de um evento invoca o manipulador de eventos por meio de um delegado. Para obter mais informações, consulte Manipulação e geração de eventos.

O OnSubscribeControlEvents método também permite que classes derivadas manipulem o evento sem anexar um delegado. Essa é a técnica preferencial para manipular o evento em uma classe derivada.

Notas aos Herdeiros

Ao substituir OnSubscribeControlEvents(Control) em uma classe derivada, chame o método da OnSubscribeControlEvents(Control) classe base para que os delegados registrados recebam o evento.