In this topic
About the FloatingPanel control
Use the FloatingPanel control to move the floating panel and its contents dynamically around the page. The FloatingPanel control can be used with any content, including standard ASP.NET controls. A floating panel can be resized; however, resizing does not automatically modify the layout of the panel's contents.
Some Web Application Developer Framework (ADF) controls have a floating behavior and do not need to be embedded in a FloatingPanel, such as the Navigation, Magnifier, and all task controls provided with the Web ADF.
Using the control
- To add controls to the page, open or create a Web site in Visual Studio. Open a Web form in design mode, select the Toolbox panel, and expand the ArcGIS Web Controls tab. Drag and drop a FloatingPanel control onto the Web form. Resize the FloatingPanel control to a larger size.
- To add text and a control, click inside the FloatingPanel and add the text, "This is a floating panel with a map." After the text, drag a Map control inside the FloatingPanel. Resize the Map control to fill the FloatingPanel.
- Add a MapResourceManager control, which does not need to be inside the FloatingPanel. Add at least one resource to the MapResourceManager control, and set the MapResourceManager property of the Map control to the MapResourceManager previously added.
When the page displays, the floating panel can be moved, collapsed and expanded, and resized. Controls within the floating panel do not resize when the floating panel is resized.
See the following screen shot showing the controls and text on the page in Visual Studio:
The FloatingPanel control functions without explicitly setting any of its properties. For options in the properties of the control, see the Members section in this topic.
Members
The following table shows a list of properties related to the FloatingPanel control. For more reference information, see the FloatingPanel control in the library reference section.
|
Property name
|
Type
|
Description
|
|
AutoHide
|
bool
|
If set to true, the title bar and frame of the floating panel are hidden until the cursor hovers over the floating panel. By default, the child controls show.
|
|
CloseButton
|
bool
|
If set to true, the Close button shows in the upper-right corner on the floating panel. If set to false, the floating panel cannot be closed.
|
|
Docked
|
bool
|
Gets or sets the value if the panel is an immediate child of the .html document's body or whether it is docked in its parent.
|
|
DockingContainerElementID
|
string
|
Gets or sets the ID of the container that is used to dock with.
|
|
Draggable
|
bool
|
Determines if the floating panel can be moved.
|
|
Expanded
|
bool
|
If set to true, opens the page with the floating panel expanded. If set to false, the floating panel opens collapsed and shows only its title bar.
|
|
ExpandCollapseButton
|
bool
|
If set to true, shows a button in the title bar on the floating panel allowing you to expand or collapse the floating panel.
|
|
HeightResizable
|
bool
|
Gets or sets a value that determines if the panel's height is resizable.
|
|
HelpUrl
|
string
|
The uniform resource locator (URL) to the Help file that appears when the Help button is clicked.
|
|
ShowDockButton
|
bool
|
Gets or sets a value indicating if the panel can be docked and undocked from its container.
|
|
ShowDockedContextMenu
|
bool
|
Gets or sets a value indicating if the context menu shows when the panel is docked.
|
|
ShowHelp
|
bool
|
Determines if the Help button shows.
|
|
Title
|
string
|
Title text that shows on the floating panel's title bar.
|
|
TitleBarBackgroundImage
|
string
|
Gets or sets the URL of the image used when rendering the title bar.
|
|
TitleBarColor
|
color
|
Color of the floating panel's title bar.
|
|
TitleBarCssClass
|
string
|
Gets or sets the Cascading Style Sheets (CSS) class used by the title bar.
|
|
TitleBarForeColor
|
color
|
Gets or sets the foreground color (usually, the text color) of the Web server control (inherited from WebControl).
|
|
TitleBarHeight
|
unit
|
Gets or sets the value of the title bar's height.
|
|
TitleBarSeparatorLine
|
bool
|
Gets or sets the value specifying whether to have a separator between the title bar and body of the panel.
|
|
Transparency
|
int
|
Value between 0–100 that represents a percentage of transparency for the floating panel and its contents. A value of 0 means the floating panel is completely opaque. A value of 100 means completely transparent. Transparency only applies when the floating panel is being actively moved (dragged) on the page at runtime.
|
|
Visible
|
bool
|
Gets or sets a value that indicates whether a server control is rendered as user interface (UI) on the page (inherited from the control).
|
|
WidthResizable
|
bool
|
Gets or sets a value indicating whether the panel's width is resizable.
|
Events
The following table shows events related to the FloatingPanel control. For more reference information, see the FloatingPanel control in the library reference section.
|
Event type
|
Description
|
|
ContentsRendered
|
Occurs when the panel is rendered during the server-side rendering process. Does not occur on callbacks.
|
|
Hide
|
Occurs when the panel is hidden, when the Close button is clicked, or the panel is hidden by code.
|
|
PanelCollapsed
|
Occurs when panels in the EditorTask is collapsed.
|
|
PanelExpanded
|
Occurs when panels in the EditorTask is expanded.
|
|
Shown
|
Occurs when panels show on the page.
|
See Also:
Web ADF controlsAJAX capabilities in the Web ADF
Customizing the Web Mapping application
To use the code in this topic, reference the following assemblies in your Visual Studio project. In the code files, you will need using (C#) or Imports (VB .NET) directives for the corresponding namespaces (given in parenthesis below if different from the assembly name):
ESRI.ArcGIS.ADF.Web.UI.WebControls.dll