ToolStripControlHost.OnSubscribeControlEvents(Control) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Suscribe eventos procedentes del control 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

Control a partir del cual se suscribirán eventos.

Ejemplos

En el ejemplo de código siguiente se muestra cómo configurar el control de eventos para un evento expuesto por el control hospedado. Este ejemplo de código es parte de un ejemplo mayor proporcionado para la clase ToolStripControlHost.

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

Comentarios

Invalide el OnSubscribeControlEvents método para agregar o evitar la sincronización de eventos de control.

Si invalida y enlaza eventos aquí, desenganchelos mediante el OnUnsubscribeControlEvents método .

Cuando se genera un evento, se invoca el controlador de eventos a través de un delegado. Para obtener más información, consulte controlar y provocar eventos.

El método OnSubscribeControlEvents también permite que las clases derivadas controlen el evento sin adjuntar ningún delegado. Ésta es la técnica preferida para controlar el evento en una clase derivada.

Notas a los desarrolladores de herederos

Al reemplazar OnSubscribeControlEvents(Control) en una clase derivada, asegúrese de llamar al método OnSubscribeControlEvents(Control) de la clase base para que los delegados registrados reciban el evento.