com.jgoodies.forms.factories
Class Forms

java.lang.Object
  com.jgoodies.forms.factories.Forms

public final class Forms
extends Object

Provides convenience behavior for building forms.

Since:

1.6

Version:

$Revision: 1.1 $

Author:

Karsten Lentzsch

Method Summary

static JComponent	border(Border border, JComponent component) Creates and returns a panel where component is surrounde by the given border.
static JComponent	border(String emptyBorderSpec, JComponent component) Creates and returns a panel where component is surrounde by an empty border as described by emptyBorderSpec.
protected static JComponent	buildGroupedButtonBar(AbstractButton... buttons) Builds and returns a button bar that consists of the given buttons.
static JComponent	buttonBar(JComponent... buttons) Creates and returns a panel where the given buttons are laid ou using a ButtonBarBuilder.
static JComponent	centered(JComponent component) Creates and returns a panel where component is centered.
static JComponent	checkBoxBar(JCheckBox... checkBoxes) Builds and returns a panel where the given check boxes are laid ou in a row.
static JComponent	horizontal(String gapColSpec, JComponent... components) Builds and returns a panel where the given components are laid ou horizontally separated by gaps as described by the give FormLayout gap (column) specification.
static JComponent	radioButtonBar(JRadioButton... radioButtons) Builds and returns a panel where the given radio buttons are laid ou in a row.
static JComponent	single(String columnSpec, String rowSpec, JComponent component) Creates and returns a panel where component is laid ou using a FormLayout with the given column and row specifications.
static JComponent	vertical(String gapRowSpec, JComponent... components) Builds and returns a panel where the given components are laid ou vertically separated by gaps as described by the give FormLayout gap (row) specification.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

single

public static JComponent single(String columnSpec,
                                String rowSpec,
                                JComponent component)

Creates and returns a panel where component is laid ou using a FormLayout with the given column and row specifications

Parameters:

columnSpec - a FormLayout column specification for a single column

rowSpec - a FormLayout row specification for a single row

component - the component to lay out

Returns:

the built panel

Throws:

NullPointerException - if columnSpec, rowSpec or component is null

IllegalArgumentException - if columnSpec or rowSpec

centered

public static JComponent centered(JComponent component)

Creates and returns a panel where component is centered The panel grows both horizontally and vertically as its container grows

Parameters:

component - the component to center

Returns:

the built panel

Throws:

NullPointerException - if component is null

border

public static JComponent border(Border border,
                                JComponent component)

Creates and returns a panel where component is surrounde by the given border

Parameters:

border - the border used to surround the component

component - the component to wrap

Returns:

the built panel

Throws:

NullPointerException - if border or componentnull

border

public static JComponent border(String emptyBorderSpec,
                                JComponent component)

Creates and returns a panel where component is surrounde by an empty border as described by emptyBorderSpec

Parameters:

component - the component to wrap

Returns:

the built panel

Throws:

NullPointerException - if emptyBorderSpeccomponent is null

horizontal

public static JComponent horizontal(String gapColSpec,
                                    JComponent... components)

Builds and returns a panel where the given components are laid ou horizontally separated by gaps as described by the give FormLayout gap (column) specification

Parameters:

gapColSpec - describes the horizontal gap between the components

components - the components to be laid out

Returns:

the built panel

Throws:

NullPointerException - if components is null

IllegalArgumentException - if components is empty

vertical

public static JComponent vertical(String gapRowSpec,
                                  JComponent... components)

Builds and returns a panel where the given components are laid ou vertically separated by gaps as described by the give FormLayout gap (row) specification

Parameters:

gapRowSpec - describes the vertical gap between the components

components - the components to be laid out

Returns:

the built panel

Throws:

NullPointerException - if components is null

IllegalArgumentException - if components is empty

buttonBar

public static JComponent buttonBar(JComponent... buttons)

Creates and returns a panel where the given buttons are laid ou using a ButtonBarBuilder. Equivalent to

Parameters:

buttons - the buttons to add to the button bar

Returns:

the built button bar

Throws:

NullPointerException - if buttons is null

IllegalArgumentException - if buttons is empty

See Also:

ButtonBarBuilder

checkBoxBar

public static JComponent checkBoxBar(JCheckBox... checkBoxes)

Builds and returns a panel where the given check boxes are laid ou in a row.

com.jgoodies.jsdl.common.focus.FocusTraversalUtils

Parameters:

checkBoxes - the check boxes to lay out in a row

Returns:

the built panel

Throws:

NullPointerException - if checkBoxes is null

IllegalArgumentException - if checkBoxes is empty

radioButtonBar

public static JComponent radioButtonBar(JRadioButton... radioButtons)

Builds and returns a panel where the given radio buttons are laid ou in a row.

com.jgoodies.jsdl.common.focus.FocusTraversalUtils

Parameters:

radioButtons - the radio buttons to lay out in a row

Returns:

the built panel

Throws:

NullPointerException - if radioButtons is null

IllegalArgumentException - if radioButtons is empty

buildGroupedButtonBar

protected static JComponent buildGroupedButtonBar(AbstractButton... buttons)

Builds and returns a button bar that consists of the given buttons Aims to build a focus group via the FocusTraversalUtils if in the classpath.

Returns:

the built panel