This documentation is archived and is not being maintained.

WebPartManager.DisplayModeChanging Event

Occurs after a user clicks a verb on a Web page that begins the process of changing to a different display mode.

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

public event WebPartDisplayModeCancelEventHandler DisplayModeChanging
<asp:WebPartManager OnDisplayModeChanging="WebPartDisplayModeCancelEventHandler" />

Display modes are an integral part of Web Parts applications. When users switch to a different display mode on a Web page, the page will often take on a very different appearance, depending on the purpose of the new display mode. After a user initiates the process of changing to a new display mode by clicking a verb, you might want to make certain changes in the user interface (UI) by using the NewDisplayMode property to determine what the new display mode will be, and then changing various UI elements accordingly. A useful way to do this is to override the OnDisplayModeChanging method to customize the UI.

NoteNote

For more information on display modes, see Web Parts Page Display Modes. For more information on consuming events, see How to: Consume Events in a Web Forms Application.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: