borderPane

NXML file equivalent: BorderLayout.

Arranges components within the following regions of a container:

• North

• East

• South

• West

• Center

Existing Components

When you select the boderPane layout for a UI file with existing components, click Next for Nexaweb Studio to display the Border Element Settings dialog where you select the region in which you want each of the components to appear. Click the arrow in the border position drop down list to select a component to appear in that position. You must specify a region for each component existing in the UI file, although you do not have to populate each region if you do not have enough components in the UI file to do so. When you finish assigning components to positions, click Finish.

Empty UI File

When you select the boderPane layout for an empty UI file, add a component by dragging it to the border position where you want to place it. If you drag a component to the center position, Nexaweb Studio automatically resizes it to take up the entire space of the pane. If you add components to additional border positions, the component you add may overlap the component in another position. If more than one component exists in a particular region, the most recent component obscures the previously placed one. You can then resize any overlapping component so that it no longer overlaps another one.

To change what component appears in a position that is already occupied by a component, follow these steps:

1. Select Refactor Layout, and click Next.

 The Border Element Settings dialog appears.

2. Select the arrow the drop down list of the position where you want to change what component appears and select the component to appear.

3. Click Finish.

To add a component to a position where no components are currently situated, follow these steps:

1. Select Refactor Layout, and click Next.

 The Border Element Settings dialog appears.

2. Click the arrow in a position where a component is currently located and select blank.

3. Click the arrow in the drop down list of the position where you want a component to appear. Any components not currently assigned to a position appear in the list. Select the component to situate in that position and click Finish.

Tip: You can use a panel to group components in one region of another container.

The Layout Wizard provides the following settings for a borderPane: