Inserting a Frame in a Named Area Using FrameBorderLayout

This procedure describes the steps for inserting a frame into any of the 11 predefined, named areas of frameBorderLayout.

Tip: You can also insert a frameBorderLayout within all named areas except center.

To insert a frame in a named area using frameBorderLayout:

In the Design Structure Window of the desired file, locate the parent node in which you wish to insert frameBorderLayout named children.
In the Component Palette, select Layout Components from the dropdown list, and then drag and drop the frameBorderLayout component to the parent node of your choice.
The frameBorderLayout node is inserted under the expanded parent node.
In the Design Structure Window, expand the frameBorderLayout node, then expand the frameBorderLayout Named Children node.
To insert a frame into any named area, right-click the named child node (e.g., center) and choose Insert inside <named child> | frame.
The Insert Frame dialog displays for you to enter the required source property, and other properties if desired.
Enter the URI that specifies the location of the frame contents to display.
Click OK when you are done.
The frame node is inserted and highlighted under the expanded named child node. The Property Inspector displays the properties of the new component.
In the Property Inspector, set the following attributes for the frame component:
- height - For top or bottom frames only. Enter the height in pixels or as a percentage.
- longDescURL - Enter a URL to a long description of the frame.
- name - Enter a name to identify the frame.
- scrolling - Specify whether scroll bars are available for the frame. The available options:
  - yes - Always available
  - no - Never available
  - auto - Default. Let the browser determine whether to display scroll bars, depending on size of frame and its contents.
- source - (Required) Enter the URI that specifies the location of the frame contents to display.
- width - For left or right frames only. Enter the width in pixels or as a percentage.

Note: To use data binding, see Data Binding a Component Attribute.

Example (UIX XML)

The frameBorderLayout component must be added inside a document component; it cannot be used inside a pageLayout component. To use pageHeaderLayout in your page, place the pageHeaderLayout content inside a separate UIX document (e.g., topFrame.uix), and then reference this document from the frameBorderLayout top named child.


...
<document>
  <contents>
    <frameBorderLayout>
      <top>
        <frame source="topFrame.uix" />
      </top>
      <left>
        <frame source="leftFrame.uix" name="Explorer" width="30%" />
      </left>
      <center>
        <frame source="centerFrame.uix" name="Contents" />
      </center>
    </frameBorderLayout>
  </contents>
</document>
...