ToolStripControlHost::OnUnsubscribeControlEvents Method (Control^)

 

Unsubscribes events from the hosted control.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

protected:
virtual void OnUnsubscribeControlEvents(
	Control^ control
)

Parameters

control
Type: System.Windows.Forms::Control^

The control from which to unsubscribe events.

Override the OnUnsubscribeControlEvents method to unsubscribe events subscribed in OnSubscribeControlEvents.

Raising an event invokes the event handler through a delegate. For more information, see Handling and Raising Events.

The OnUnsubscribeControlEvents method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors:

When overriding OnUnsubscribeControlEvents in a derived class, be sure to call the base class's OnUnsubscribeControlEvents method so that registered delegates receive the event.

The following code example demonstrates how to unsubscribe from an event exposed by the hosted control. This code example is part of a larger example provided for the ToolStripControlHost class.

void OnUnsubscribeControlEvents( System::Windows::Forms::Control^ c )
{

   // Call the base method so the basic events are unsubscribed.
   __super::OnUnsubscribeControlEvents( c );

   // Cast the control to a MonthCalendar control.
   MonthCalendar^ monthCalendarControl = (MonthCalendar^)c;

   // Remove the event.
   monthCalendarControl->DateChanged -= gcnew DateRangeEventHandler( this, &ToolStripMonthCalendar::HandleDateChanged );
}

.NET Framework
Available since 2.0
Return to top
Show: