Types of panes
Widgets that are designed to be containers for child widgets are called panes. Different types of panes provide different functions. The following list is a summary of some commonly used panes:
- BasicMobilePane
the default pane for mobile Px pages and required in the root of a mobile Px file.
- CanvasPane
used for absolute positioning.
- BorderPane
used to wrap one widget and provide margin, border, and padding similar to the CSS box model.
- EdgePane
supports five potential children: top, bottom, left, right, and center. The top and bottom widgets fill the pane horizontally and use their preferred height. The left and right widgets use their preferred width, and occupy the vertical space between the top and bottom. The center widget gets all the remaining space. See the figure below for an example.
- GridPane
lays out its children as a series of columns and rows. You can configure extra space in the rows and columns a number of ways using the pane’s properties.
- MobileGridPane
allows you to create row and column spacing on your mobile Px view.
- SplitPane
supports two children with a movable divider between them.
- TabbedPane
supports multiple children - only one is currently selected using a set of tabs.
NOTE: Even though only one tab is visible at a time, all tabs must be loaded on the page, even if they are not visible. If many tabs, with a lot of information, are on a single page, the page may load very slowly.
- ScrollPane
supports a single child that may have a preferred size larger than the available bounds. The scroll pane provides a set of scroll bars for viewing areas of the child widget that go outside of its bounds.
- ReportPane
supports headers and footers in report PDFs. The ReportPane allows its content to span multiple pages, and allows each page to have a common logo as well as a page number and timestamp.
NOTE: Report panes should be at the root of a Px file. If you place a report pane inside a scroll pane, then page-spanning is disabled.
The figure below illustrates the edge pane layout using borders and labels.
Figure 28. Edge panes, borders, and labels on a canvas pane
