A panel control that acts as a movable window.
public class ASPxDockPanel : ASPxPopupControlBase, IControlDesigner
Public Class ASPxDockPanel Inherits ASPxPopupControlBase Implements IControlDesigner
Related API Members
The following members accept/return ASPxDockPanel objects:
The ASPxDockPanel control is a window that can be dragged around the Web page and docked in zones.
An ASPxDockPanel object has a unique identifier specified via the ASPxDockPanel.PanelUID property. This property can be used to obtain a panel at runtime on the server (ASPxDockManager.FindPanelByUID) or client (ASPxClientDockManager.GetPanelByUID and ASPxClientDockZone.GetPanelByUID) side. If the panel is docked, the ASPxDockPanel.OwnerZone and ASPxDockPanel.OwnerZoneUID properties can be used to obtain the panel's owner.
A panel may consist of the following elements:
- A header which can display an image (PopupControlImages.Header), text (ASPxPopupControlBase.HeaderText) and a specific close button, which when clicked, closes the panel. End-users can move a panel within the page by dragging the window's header, if the ASPxDockPanel.AllowDragging property is set to true. The header's visibility is controlled by the ASPxPopupControlBase.ShowHeader property. The ASPxPopupControlBase.DragElement property is used to specify the panel section that is available for drag and drop operations.
- A footer which can display an image (PopupControlImages.Footer), text (ASPxPopupControlBase.FooterText) and size grip (PopupControlImages.SizeGrip). The footer's visibility is controlled by the ASPxPopupControlBase.ShowFooter property.
- A content area which can display a content text (ASPxPopupControlBase.Text) and which allows different visual elements to be added through the ASPxPopupControlBase.Controls property. A panel's content can also be visualized by an external web page specified via the ASPxPopupControlBase.ContentUrl property.
A popup element (i.e., ASPxPopupControl or ASPxDockPanel) cannot contain another popup element inside.
The ASPxDockPanel height and width (accessible by the ASPxWebControl.Height and ASPxWebControl.Width properties) cannot be set as a percentage. Set the dimensions in pixels to correctly display the control in all browsers.
When using the ASPxDockPanel with the ContentUrl property specified, the dock panel loads its content page within an iframe element. After docking/floating the ASPxDockPanel from the ASPxDockZone, the dock panel's iframe is removed from the DOM tree and reloaded. As a result, the script execution is stopped inside the iframe and the DOM API of the iframe window is no longer available. This behavior is a known issue of the IE 9 browser described in the APIs Are Not Available if iFrame Is Removed from DOM Tree MSDN article.