ComponentEventHandler Delegate
Represents the method that will handle the ComponentAdding, ComponentAdded, ComponentRemoving, and ComponentRemoved events raised for component-level events.
Assembly: System (in System.dll)
[ComVisibleAttribute(true)] [HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)] public delegate void ComponentEventHandler( object sender, ComponentEventArgs e )
Parameters
- sender
-
Type:
System.Object
The source of the event.
- e
-
Type:
System.ComponentModel.Design.ComponentEventArgs
A ComponentEventArgs that contains the event data.
When you create a ComponentEventHandler delegate, you identify the method that will handle the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For more information about event-handler delegates, see NIB: Events and Delegates.
The following example demonstrates registering a ComponentEventHandler and handling the ComponentAdded, ComponentAdding, ComponentRemoved and ComponentRemoving events.
public void LinkComponentEvent(IComponentChangeService changeService) { // Registers an event handler for the ComponentAdded, // ComponentAdding, ComponentRemoved, and ComponentRemoving events. changeService.ComponentAdded += new ComponentEventHandler(this.OnComponentEvent); changeService.ComponentAdding += new ComponentEventHandler(this.OnComponentEvent); changeService.ComponentRemoved += new ComponentEventHandler(this.OnComponentEvent); changeService.ComponentRemoving += new ComponentEventHandler(this.OnComponentEvent); } private void OnComponentEvent(object sender, ComponentEventArgs e) { // Displays changed component information on the console. if( e.Component.Site != null ) Console.WriteLine("Name of the component related to the event: "+e.Component.Site.Name); Console.WriteLine("Type of the component related to the event: "+e.Component.GetType().FullName); }
Available since 1.1