com.jgoodies.forms.internal

Class AbstractButtonPanelBuilder<B extends AbstractButtonPanelBuilder<B>>

java.lang.Object

com.jgoodies.forms.internal.AbstractBuilder<B>

com.jgoodies.forms.internal.AbstractButtonPanelBuilder<B>

Type Parameters:

B - the type of the builder, e.g. ButtonBarBuilder

Direct Known Subclasses:

ButtonBarBuilder, ButtonStackBuilder

public abstract class AbstractButtonPanelBuilder<B extends AbstractButtonPanelBuilder<B>>
extends AbstractBuilder<B>

The abstract superclass for ButtonBarBuilder and ButtonStackBuilder. Provides a cell cursor for traversing the button bar/stack while components are added. It also offers convenience methods to append logical columns and rows.

Since:

1.2

Version:

$Revision: 1.11 $

Author:

Karsten Lentzsch

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	focusGrouped Indicates whether a focus group has been built in build().

Fields inherited from class com.jgoodies.forms.internal.AbstractBuilder

currentCellConstraints

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractButtonPanelBuilder(FormLayout layout, JPanel container) Constructs an AbstractButtonPanelBuilder for the given FormLayout and layout container.

Method Summary

Methods

Modifier and Type	Method and Description
protected Component	add(Component component) Adds a component to the container using the default cell constraints.
protected AbstractButtonPanelBuilder	addButton(Action... actions) Constructs an array of JButtons from the given Action array, and adds them as a sequence of related buttons separated by a default gap.
protected AbstractButtonPanelBuilder	addButton(JComponent... buttons) Adds one or many sequences of related buttons.
protected abstract AbstractButtonPanelBuilder	addButton(JComponent button)
protected abstract AbstractButtonPanelBuilder	addRelatedGap() Adds the standard gap for related components.
protected abstract AbstractButtonPanelBuilder	addUnrelatedGap() Adds the standard gap for unrelated components.
protected void	appendColumn(ColumnSpec columnSpec) Appends the given column specification to the builder's layout.
protected void	appendGlueColumn() Appends a glue column.
protected void	appendGlueRow() Appends a glue row.
protected void	appendRelatedComponentsGapColumn() Appends a column that is the default gap for related components.
protected void	appendRelatedComponentsGapRow() Appends a row that is the default gap for related components.
protected void	appendRow(RowSpec rowSpec) Appends the given row specification to the builder's layout.
protected void	appendUnrelatedComponentsGapColumn() Appends a column that is the default gap for unrelated components.
protected void	appendUnrelatedComponentsGapRow() Appends a row that is the default gap for unrelated components.
JPanel	build() Returns the panel used to build the form and lazily builds a focus traversal group for all contained AbstractButtons.
protected JButton	createButton(Action action) Creates and returns a button that is bound to the given Action.
protected int	getColumn()
protected int	getRow() Returns the cursor's row.
boolean	isLeftToRight() Returns whether this builder fills the form left-to-right or right-to-left.
protected void	nextColumn() Moves to the next column, does the same as #nextColumn(1).
protected void	nextRow() Increases the row by one; does the same as #nextRow(1).
void	setBackground(Color background) Deprecated. Replaced by AbstractBuilder.background(Color)
void	setBorder(Border border) Deprecated. Replaced by AbstractBuilder.border(Border)
void	setLeftToRight(boolean b) Sets the form fill direction to left-to-right or right-to-left.
void	setOpaque(boolean b) Deprecated. Replaced by AbstractBuilder.opaque(boolean)

Methods inherited from class com.jgoodies.forms.internal.AbstractBuilder

background, border, border, createComponentFactory, getColumnCount, getComponentFactory, getContainer, getLayout, getPanel, getRowCount, opaque, padding, padding, setComponentFactory

Methods inherited from class java.lang.Object

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

Field Detail

focusGrouped

protected boolean focusGrouped

Indicates whether a focus group has been built in build(). Reset to false whenever a component is added.

Constructor Detail

AbstractButtonPanelBuilder

protected AbstractButtonPanelBuilder(FormLayout layout,
                          JPanel container)

Constructs an AbstractButtonPanelBuilder for the given FormLayout and layout container.

Parameters:

layout - the FormLayout to use

container - the layout container

Throws:

NullPointerException - if layout or container is null

Method Detail

build

public final JPanel build()

Returns the panel used to build the form and lazily builds a focus traversal group for all contained AbstractButtons.

Specified by:

build in class AbstractBuilder<B extends AbstractButtonPanelBuilder<B>>

Returns:

the panel used by this builder to build the form

setBackground

@Deprecated
public final void setBackground(Color background)

Deprecated. Replaced by AbstractBuilder.background(Color)

Sets the panel's background color and makes the panel opaque.

Parameters:

background - the color to set as new background

See Also:

JComponent.setBackground(Color)

setBorder

@Deprecated
public final void setBorder(Border border)

Deprecated. Replaced by AbstractBuilder.border(Border)

Sets the panel's border.

Parameters:

border - the border to set

See Also:

JComponent.setBorder(Border)

setOpaque

@Deprecated
public final void setOpaque(boolean b)

Deprecated. Replaced by AbstractBuilder.opaque(boolean)

Sets the panel's opaque state.

Parameters:

b - true for opaque, false for non-opaque

Since:

1.1

See Also:

JComponent.setOpaque(boolean)

isLeftToRight

public final boolean isLeftToRight()

Returns whether this builder fills the form left-to-right or right-to-left. The initial value of this property is set during the builder construction from the layout container's componentOrientation property.

Returns:

true indicates left-to-right, false indicates right-to-left

See Also:

setLeftToRight(boolean), ComponentOrientation

setLeftToRight

public final void setLeftToRight(boolean b)

Sets the form fill direction to left-to-right or right-to-left. The initial value of this property is set during the builder construction from the layout container's componentOrientation property.

Parameters:

b - true indicates left-to-right, false right-to-left

See Also:

isLeftToRight(), ComponentOrientation

nextColumn

protected final void nextColumn()

Moves to the next column, does the same as #nextColumn(1).

getColumn

protected final int getColumn()

getRow

protected final int getRow()

Returns the cursor's row.

Returns:

the cursor's row

nextRow

protected final void nextRow()

Increases the row by one; does the same as #nextRow(1).

appendColumn

protected final void appendColumn(ColumnSpec columnSpec)

Appends the given column specification to the builder's layout.

Parameters:

columnSpec - the column specification object to append

appendGlueColumn

protected final void appendGlueColumn()

Appends a glue column.

See Also:

appendRelatedComponentsGapColumn(), appendUnrelatedComponentsGapColumn()

appendRelatedComponentsGapColumn

protected final void appendRelatedComponentsGapColumn()

Appends a column that is the default gap for related components.

See Also:

appendGlueColumn(), appendUnrelatedComponentsGapColumn()

appendUnrelatedComponentsGapColumn

protected final void appendUnrelatedComponentsGapColumn()

Appends a column that is the default gap for unrelated components.

See Also:

appendGlueColumn(), appendRelatedComponentsGapColumn()

appendRow

protected final void appendRow(RowSpec rowSpec)

Appends the given row specification to the builder's layout.

Parameters:

rowSpec - the row specification object to append

appendGlueRow

protected final void appendGlueRow()

Appends a glue row.

See Also:

appendRelatedComponentsGapRow(), appendUnrelatedComponentsGapRow()

appendRelatedComponentsGapRow

protected final void appendRelatedComponentsGapRow()

Appends a row that is the default gap for related components.

See Also:

appendGlueRow(), appendUnrelatedComponentsGapRow()

appendUnrelatedComponentsGapRow

protected final void appendUnrelatedComponentsGapRow()

Appends a row that is the default gap for unrelated components.

See Also:

appendGlueRow(), appendRelatedComponentsGapRow()

add

protected final Component add(Component component)

Adds a component to the container using the default cell constraints. Note that when building from left to right, this method won't adjust the cell constraints if the column span is larger than 1.

Parameters:

component - the component to add

Returns:

the added component

addButton

protected abstract AbstractButtonPanelBuilder addButton(JComponent button)

addButton

protected AbstractButtonPanelBuilder addButton(JComponent... buttons)

Adds one or many sequences of related buttons. A new sequence starts when a button is null. The next sequence is separated by an unrelated gap. Each button has the minimum width as specified by LayoutStyle.getDefaultButtonWidth(). The gap width between the buttons is LayoutStyle.getRelatedComponentsPadX().

Although JButtons are expected, general JComponents are accepted to allow custom button component types.

Examples:

 builder.addButtons(newButton, editButton, deleteButton);
 builder.addButtons(newButton, editButton, deleteButton, null, printButton);
 

Parameters:

buttons - the buttons to add

Returns:

this builder

Throws:

NullPointerException - if buttons is null

IllegalArgumentException - if buttons is empty

See Also:

addButton(JComponent)

addButton

protected AbstractButtonPanelBuilder addButton(Action... actions)

Constructs an array of JButtons from the given Action array, and adds them as a sequence of related buttons separated by a default gap.

Parameters:

actions - an array of buttons to add

addRelatedGap

protected abstract AbstractButtonPanelBuilder addRelatedGap()

Adds the standard gap for related components.

addUnrelatedGap

protected abstract AbstractButtonPanelBuilder addUnrelatedGap()

Adds the standard gap for unrelated components.

createButton

protected JButton createButton(Action action)

Creates and returns a button that is bound to the given Action. This is a hook that allows to return customized buttons. For example, the JGoodies JGButton configures the accessible name and accessible description from Actions that provide these information.

This default implementation delegates the button creation to this builder's component factory, see ComponentFactory.createButton(Action)).

Parameters:

action - provides bound visual properties for the button

Returns:

the created button

Since:

1.4