ASPxPanel Class
Represents a panel control that acts as a container for other controls.
Namespace: DevExpress.Web
Assembly: DevExpress.Web.v24.1.dll
NuGet Package: DevExpress.Web
Declaration
Remarks
The ASPxPanel control is a container area for other controls. It is useful when you want to generate controls programmatically, hide/show a group of controls, etc. You can populate the ASPxPanel with other controls using the ASPxPanelContainerBase.Controls property and the PanelContent control.
Create a Panel
Design Time
The ASPxPanel control is available on the DX.24.1: Navigation & Layout toolbox tab in the Microsoft Visual Studio IDE.
Drag the control onto a form and customize the control’s settings, or paste the control markup in the page’s source code.
<dx:ASPxPanel ID="TopPanel" runat="server" Collapsible="true"
FixedPosition="WindowTop" ClientInstanceName="ClientPanel">
<SettingsAdaptivity CollapseAtWindowInnerWidth="624" />
<PanelCollection>
<dx:PanelContent runat="server">
<dx:ASPxMenu ID="HeaderMenu" runat="server">
<Items>
<dx:MenuItem Text="Data"></dx:MenuItem>
<dx:MenuItem Text="Settings"></dx:MenuItem>
<dx:MenuItem Text="Profile"></dx:MenuItem>
<dx:MenuItem Text="Help"></dx:MenuItem>
</Items>
</dx:ASPxMenu>
</dx:PanelContent>
</PanelCollection>
</dx:ASPxPanel>
Run Time
using DevExpress.Web;
using MenuItem = DevExpress.Web.MenuItem;
...
protected void Page_Load(object sender, EventArgs e) {
ASPxPanel panel = new ASPxPanel();
panel.ID = "TopPanel";
panel.ClientInstanceName = "ClientPanel";
panel.FixedPosition = PanelFixedPosition.WindowTop;
panel.Collapsible = true;
panel.SettingsAdaptivity.CollapseAtWindowInnerWidth = 624;
ASPxMenu menu = new ASPxMenu();
menu.ID = "HeaderMenu";
menu.Items.AddRange(new List<MenuItem>() {
new MenuItem("Data"),
new MenuItem("Settings"),
new MenuItem("Profile"),
new MenuItem("Help")
});
panel.Controls.Add(menu);
Page.Form.Controls.Add(panel);
}
Note
DevExpress controls require that you register special modules, handlers, and options in the Web.config file. You can change this file or switch to the Design tab in the Microsoft Visual Studio IDE to automatically update the Web.config file. Note that this information is automatically registered if you use the DevExpress Template Gallery to create a project.
The ASPxPanel control inherits all its functionality from the base ASPxPanelBase class. This functionality enables the panel’s child controls to be manipulated (ASPxPanelContainerBase.Controls), the panel’s default button to be specified (ASPxPanelBase.DefaultButton), the panel’s initial visibility on the client to be defined (ASPxPanelBase.ClientVisible) etc. In addition, the ASPxPanel class implements the ASPxCollapsiblePanel.RenderMode property that allows you to specify how the panel should be rendered into the page.
Note
The ASPxPanel control provides you with a comprehensive client-side functionality implemented using JavaScript code:
- The control’s client-side equivalent is represented by the ASPxClientPanel object.
- On the client side, the client object can be accessed directly by the name specified via the ASPxPanelBase.ClientInstanceName property.
- The available client events can be accessed by using the ASPxPanel.ClientSideEvents property.
The control’s client-side API is enabled if the ASPxCollapsiblePanel.EnableClientSideAPI property is set to true, or the ASPxPanelBase.ClientInstanceName property is defined, or any client event is handled.