EditorZoneBase.OnSelectedWebPartChanged Method (Object, WebPartEventArgs)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Raises the SelectedWebPartChanged event and sets the EditorParts collection to null in the zone in preparation for a WebPart control to enter or exit edit mode.

Namespace:   System.Web.UI.WebControls.WebParts
Assembly:  System.Web (in System.Web.dll)

protected override void OnSelectedWebPartChanged(
	object sender,
	WebPartEventArgs e


Type: System.Object

An Object that raises the SelectedWebPartChanged event.

Type: System.Web.UI.WebControls.WebParts.WebPartEventArgs

A WebPartDisplayModeEventArgs that contains the event data.

The OnSelectedWebPartChanged method enables you to provide custom handling for the event that occurs when an individual WebPart control enters or exits edit mode.

Notes to Inheritors:

The OnSelectedWebPartChanged method can be overridden or called programmatically in a custom editor zone control that inherits from the EditorZoneBase class or the EditorZone class.

The following code example demonstrates how to override the OnSelectedWebPartChanged method in a derived class. For the full code required to run the example, see the Example section of the EditorZoneBase class overview topic.

The custom editor zone derives from the EditorZone class so that it can be used with a zone template in the declarative markup of the Web page. The custom class overrides the OnSelectedWebPartChanged method, setting the background color of the specific control that is being edited, and then calls the base method.

protected override void OnSelectedWebPartChanged(object sender, 
  WebPartEventArgs e)
  if (e.WebPart != null)
    e.WebPart.Zone.SelectedPartChromeStyle.BackColor = 
  base.OnSelectedWebPartChanged(sender, e);

When you load the page in a browser, you can select Edit Mode in the drop-down list control to switch to edit mode. You can click the verbs menu (the down arrow) in the title bar of one of the controls, and click Edit to edit the selected control. When the EditorZone and editing user interface (UI) are visible, you can see that the selected control has the background color specified in the code.

.NET Framework
Available since 2.0
Return to top