Adding New Panels to a Builder Container

Both QueryBuilder and CalcBuilder use a similar architecture for establishing their context, container, and panels. The following list shows the objects and interfaces that are used when working with a builder, its container, and panels:

To add a panel to a builder container:

  1. Ensure that the panel implements the StandardPanel interface. The easiest way to accomplish this is to derive a class from the DefaultStandardPanel class in oracle.dss.datautil.gui.panel.

  2. Override some methods of the DefaultStandardPanel class.

  3. Create an instance of the new DefaultStandardPanel class that you derived in Step 1. Ensure that this instance has a unique panel ID.

  4. Add the new panel object by calling the addPanel method of the builder object, which requires two parameters.

    The first parameter identifies the panel to add. If you use a null value for the second parameter, then the new panel is added at the end of the container. To insert the panel in a different location, use the ID of the panel that should follow the new panel as the second parameter.

    Tip: Use care when adding a panel before the Welcome panel. The CalcBuilder or QueryBuilder considers your newly added panel as the Welcome panel and so does not assign a step number to your panel. After displaying your newly added panel first, the CalcBuilder or QueryBuilder displays its Welcome panel with the text "Step 1 of x" in the title bar, where x represents the number of the steps in the wizard.

  5. Run the CalcBuilder or QueryBuilder.

Overriding following methods of the DefaultStandardPanel class

The following list describes the methods of the DefaultStandardPanel class that you should override:

Adding or Removing Builder Panels at Runtime