ToolStripControlHost.OnSubscribeControlEvents(Control) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Subskrybuje zdarzenia z hostowanej kontrolki.

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)

Parametry

control

Control

Kontrolka, z której mają być subskrybowane zdarzenia.

Przykłady

W poniższym przykładzie kodu pokazano, jak skonfigurować obsługę zdarzeń dla zdarzenia uwidocznionego przez hostowaną kontrolkę. Ten przykład kodu jest częścią większego przykładu udostępnionego ToolStripControlHost dla klasy .

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

Uwagi

Zastąpij metodę OnSubscribeControlEvents , aby dodać lub uniemożliwić synchronizowanie zdarzeń sterujących.

Jeśli w tym miejscu przesłonisz i podłączesz zdarzenia, usuń je przy użyciu OnUnsubscribeControlEvents metody .

Podnoszenie zdarzenia wywołuje program obsługi zdarzeń przez delegata. Aby uzyskać więcej informacji, zobacz Obsługa i podnoszenie zdarzeń.

Metoda OnSubscribeControlEvents umożliwia również klasom pochodnym obsługę zdarzenia bez dołączania delegata. Jest to preferowana technika obsługi zdarzenia w klasie pochodnej.

Uwagi dotyczące dziedziczenia

Podczas zastępowania OnSubscribeControlEvents(Control) w klasie pochodnej należy wywołać metodę klasy OnSubscribeControlEvents(Control) bazowej, aby zarejestrowani delegaci odbierali zdarzenie.