Class PanelBuilder
- java.lang.Object
-
- com.jgoodies.forms.builder.AbstractFormBuilder
-
- com.jgoodies.forms.builder.PanelBuilder
-
- Direct Known Subclasses:
AbstractI15dPanelBuilder
,ButtonBarBuilder
,ButtonStackBuilder
public class PanelBuilder extends AbstractFormBuilder
An general purpose panel builder that uses theFormLayout
to lay outJPanel
s. It provides convenience methods to set a default border and to add labels, titles and titled separators.The PanelBuilder is the working horse for layouts when more specialized builders like the
ButtonBarBuilder2
orDefaultFormBuilder
are inappropriate.The Forms tutorial includes several examples that present and compare different style to build with the PanelBuilder: static row numbers vs. row variable, explicit CellConstraints vs. builder cursor, static rows vs. dynamically added rows. Also, you may check out the Tips & Tricks section of the Forms HTML documentation.
The text arguments passed to the methods
#addLabel
,#addTitle
, and#addSeparator
can contain an optional mnemonic marker. The mnemonic and mnemonic index are indicated by a single ampersand (&). For example "&Save", or "Save &as". To use the ampersand itself duplicate it, for example "Look&&Feel".Example:
This example creates a panel with 3 columns and 3 rows.FormLayout layout = new FormLayout( "pref, $lcgap, 50dlu, $rgap, default", // columns "pref, $lg, pref, $lg, pref"); // rows PanelBuilder builder = new PanelBuilder(layout); CellConstraints cc = new CellConstraints(); builder.addLabel("&Title:", cc.xy (1, 1)); builder.add(new JTextField(), cc.xywh(3, 1, 3, 1)); builder.addLabel("&Price:", cc.xy (1, 3)); builder.add(new JTextField(), cc.xy (3, 3)); builder.addLabel("&Author:", cc.xy (1, 5)); builder.add(new JTextField(), cc.xy (3, 5)); builder.add(new JButton("?"), cc.xy (5, 5)); return builder.getPanel();
- Version:
- $Revision: 1.15 $
- Author:
- Karsten Lentzsch
- See Also:
ComponentFactory
,I15dPanelBuilder
,DefaultFormBuilder
-
-
Constructor Summary
Constructors Constructor Description PanelBuilder(FormLayout layout)
Constructs aPanelBuilder
for the given layout.PanelBuilder(FormLayout layout, javax.swing.JPanel panel)
Constructs aPanelBuilder
for the given FormLayout and layout container.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description java.awt.Component
add(java.awt.Component component, CellConstraints cellConstraints)
Adds a component to the panel using the given cell constraints.javax.swing.JLabel
add(javax.swing.JLabel label, CellConstraints labelConstraints, java.awt.Component component, CellConstraints componentConstraints)
Adds a label and component to the panel using the given cell constraints.javax.swing.JLabel
addLabel(java.lang.String textWithMnemonic)
Adds a textual label to the form using the default constraints.javax.swing.JLabel
addLabel(java.lang.String textWithMnemonic, CellConstraints constraints)
Adds a textual label to the form using the specified constraints.javax.swing.JLabel
addLabel(java.lang.String textWithMnemonic, CellConstraints labelConstraints, java.awt.Component component, CellConstraints componentConstraints)
Adds a label and component to the panel using the given cell constraints.javax.swing.JLabel
addLabel(java.lang.String textWithMnemonic, java.lang.String encodedConstraints)
Adds a textual label to the form using the specified constraints.javax.swing.JLabel
addROLabel(java.lang.String textWithMnemonic)
Adds a textual label intended for labeling read-only components to the form using the default constraints.javax.swing.JLabel
addROLabel(java.lang.String textWithMnemonic, CellConstraints constraints)
Adds a textual label intended for labeling read-only components to the form using the specified constraints.javax.swing.JLabel
addROLabel(java.lang.String textWithMnemonic, CellConstraints labelConstraints, java.awt.Component component, CellConstraints componentConstraints)
Adds a label and component to the panel using the given cell constraints.javax.swing.JLabel
addROLabel(java.lang.String textWithMnemonic, java.lang.String encodedConstraints)
Adds a textual label intended for labeling read-only components to the form using the specified constraints.javax.swing.JComponent
addSeparator(java.lang.String textWithMnemonic)
Adds a titled separator to the form that spans all columns.javax.swing.JComponent
addSeparator(java.lang.String textWithMnemonic, int columnSpan)
Adds a titled separator to the form that spans the specified columns.javax.swing.JComponent
addSeparator(java.lang.String textWithMnemonic, CellConstraints constraints)
Adds a titled separator to the form using the specified constraints.javax.swing.JComponent
addSeparator(java.lang.String textWithMnemonic, java.lang.String encodedConstraints)
Adds a titled separator to the form using the specified constraints.javax.swing.JLabel
addTitle(java.lang.String textWithMnemonic)
Adds a title label to the form using the default constraints.javax.swing.JLabel
addTitle(java.lang.String textWithMnemonic, CellConstraints constraints)
Adds a title label to the form using the specified constraints.javax.swing.JLabel
addTitle(java.lang.String textWithMnemonic, java.lang.String encodedConstraints)
Adds a title label to the form using the specified constraints.ComponentFactory
getComponentFactory()
Returns the builder's component factory.static boolean
getLabelForFeatureEnabledDefault()
Returns the global default for the enablement of the setLabelFor feature.javax.swing.JPanel
getPanel()
Returns the panel used to build the form.protected boolean
isLabelForApplicable(javax.swing.JLabel label, java.awt.Component component)
Checks and answers whether the given component shall be set as component for a previously added label usingJLabel.setLabelFor(Component)
.boolean
isLabelForFeatureEnabled()
Returns whether the setLabelFor feature is enabled for this PanelBuilder.void
setBackground(java.awt.Color background)
Sets the panel's background color.void
setBorder(javax.swing.border.Border border)
Sets the panel's border.void
setComponentFactory(ComponentFactory newFactory)
Sets a new component factory.void
setDefaultDialogBorder()
Sets the default dialog border.protected void
setLabelFor(javax.swing.JLabel label, java.awt.Component component)
Setslabel
as labeling label forcomponent
or an appropriate child.void
setLabelForFeatureEnabled(boolean b)
Enables or disables the setLabelFor feature for this PanelBuilder.static void
setLabelForFeatureEnabledDefault(boolean b)
Sets the default value for the setLabelFor feature enablement.void
setOpaque(boolean b)
Sets the panel's opaque state.-
Methods inherited from class com.jgoodies.forms.builder.AbstractFormBuilder
add, add, appendColumn, appendColumn, appendGlueColumn, appendGlueRow, appendLabelComponentsGapColumn, appendParagraphGapRow, appendRelatedComponentsGapColumn, appendRelatedComponentsGapRow, appendRow, appendRow, appendUnrelatedComponentsGapColumn, appendUnrelatedComponentsGapRow, cellConstraints, createLeftAdjustedConstraints, getColumn, getColumnCount, getColumnIncrementSign, getContainer, getLayout, getLeadingColumn, getRow, getRowCount, isLeftToRight, nextColumn, nextColumn, nextLine, nextLine, nextRow, nextRow, setAlignment, setBounds, setColumn, setColumnSpan, setExtent, setHAlignment, setLeftToRight, setOrigin, setRow, setRowSpan, setVAlignment
-
-
-
-
Constructor Detail
-
PanelBuilder
public PanelBuilder(FormLayout layout)
Constructs aPanelBuilder
for the given layout. Uses an instance ofJPanel
as layout container with the given layout as layout manager.- Parameters:
layout
- the FormLayout to use
-
PanelBuilder
public PanelBuilder(FormLayout layout, javax.swing.JPanel panel)
Constructs aPanelBuilder
for the given FormLayout and layout container.- Parameters:
layout
- the FormLayout to usepanel
- the layout container to build on
-
-
Method Detail
-
getLabelForFeatureEnabledDefault
public static boolean getLabelForFeatureEnabledDefault()
Returns the global default for the enablement of the setLabelFor feature. This can be overridden per PanelBuilder usingsetLabelForFeatureEnabled(boolean)
. The feature is globally disabled by default.- Returns:
- true for globally enabled, false for globally disabled
-
setLabelForFeatureEnabledDefault
public static void setLabelForFeatureEnabledDefault(boolean b)
Sets the default value for the setLabelFor feature enablement. This can be overridden per PanelBuilder usingsetLabelForFeatureEnabled(boolean)
. The default value is used to set the initial PanelBuilder setting for this feature. The feature is globally disabled by default.- Parameters:
b
- true for globally enabled, false for globally disabled
-
isLabelForFeatureEnabled
public boolean isLabelForFeatureEnabled()
Returns whether the setLabelFor feature is enabled for this PanelBuilder. The value is initialized from the global default value for this featuregetLabelForFeatureEnabledDefault()
. It is globally disabled by default.- Returns:
- true for enabled, false for disabled
-
setLabelForFeatureEnabled
public void setLabelForFeatureEnabled(boolean b)
Enables or disables the setLabelFor feature for this PanelBuilder. The value is initialized from the global default valuegetLabelForFeatureEnabledDefault()
. It is globally disabled by default.- Parameters:
b
- true for enabled, false for disabled
-
getPanel
public final javax.swing.JPanel getPanel()
Returns the panel used to build the form.- Returns:
- the panel used by this builder to build the form
-
setBackground
public final void setBackground(java.awt.Color background)
Sets the panel's background color.- Parameters:
background
- the color to set as new background- Since:
- 1.1
- See Also:
JComponent.setBackground(Color)
-
setBorder
public final void setBorder(javax.swing.border.Border border)
Sets the panel's border.- Parameters:
border
- the border to set- See Also:
JComponent.setBorder(Border)
-
setDefaultDialogBorder
public final void setDefaultDialogBorder()
Sets the default dialog border.- See Also:
Borders
-
setOpaque
public final void setOpaque(boolean b)
Sets the panel's opaque state.- Parameters:
b
- true for opaque, false for non-opaque- Since:
- 1.1
- See Also:
JComponent.setOpaque(boolean)
-
addLabel
public final javax.swing.JLabel addLabel(java.lang.String textWithMnemonic)
Adds a textual label to the form using the default constraints.addLabel("Name:"); // No Mnemonic addLabel("N&ame:"); // Mnemonic is 'a' addLabel("Save &as:"); // Mnemonic is the second 'a' addLabel("Look&&Feel:"); // No mnemonic, text is "look&feel"
- Parameters:
textWithMnemonic
- the label's text - may contain an ampersand (&) to mark a mnemonic- Returns:
- the new label
- See Also:
ComponentFactory
-
addLabel
public final javax.swing.JLabel addLabel(java.lang.String textWithMnemonic, CellConstraints constraints)
Adds a textual label to the form using the specified constraints.addLabel("Name:", cc.xy(1, 1)); // No Mnemonic addLabel("N&ame:", cc.xy(1, 1)); // Mnemonic is 'a' addLabel("Save &as:", cc.xy(1, 1)); // Mnemonic is the second 'a' addLabel("Look&&Feel:", cc.xy(1, 1)); // No mnemonic, text is "look&feel"
- Parameters:
textWithMnemonic
- the label's text - may contain an ampersand (&) to mark a mnemonicconstraints
- the label's cell constraints- Returns:
- the new label
- See Also:
ComponentFactory
-
addLabel
public final javax.swing.JLabel addLabel(java.lang.String textWithMnemonic, java.lang.String encodedConstraints)
Adds a textual label to the form using the specified constraints.addLabel("Name:", "1, 1"); // No Mnemonic addLabel("N&ame:", "1, 1"); // Mnemonic is 'a' addLabel("Save &as:", "1, 1"); // Mnemonic is the second 'a' addLabel("Look&&Feel:", "1, 1"); // No mnemonic, text is "look&feel"
- Parameters:
textWithMnemonic
- the label's text - may contain an ampersand (&) to mark a mnemonicencodedConstraints
- a string representation for the constraints- Returns:
- the new label
- See Also:
ComponentFactory
-
addLabel
public final javax.swing.JLabel addLabel(java.lang.String textWithMnemonic, CellConstraints labelConstraints, java.awt.Component component, CellConstraints componentConstraints)
Adds a label and component to the panel using the given cell constraints. Sets the given label as the component label usingJLabel.setLabelFor(java.awt.Component)
.Note: The
CellConstraints
objects for the label and the component must be different. Cell constraints are implicitly cloned by theFormLayout
when added to the container. However, in this case you may be tempted to reuse aCellConstraints
object in the same way as with many other builder methods that require a singleCellConstraints
parameter. The pitfall is that the methodsCellConstraints.xy*(...)
just set the coordinates but do not create a new instance. And so the second invocation ofxy*(...)
overrides the settings performed in the first invocation before the object is cloned by theFormLayout
.Wrong:
builder.addLabel( "&Name:", // Mnemonic is 'N' cc.xy(1, 7), // will be modified by the code below nameField, cc.xy(3, 7) // sets the single instance to (3, 7) );
Correct:// Using a single CellConstraints instance and cloning CellConstraints cc = new CellConstraints(); builder.addLabel( "&Name:", (CellConstraints) cc.xy(1, 7).clone(), // cloned before the next modification nameField, cc.xy(3, 7) // sets this instance to (3, 7) ); // Using two CellConstraints instances CellConstraints cc1 = new CellConstraints(); CellConstraints cc2 = new CellConstraints(); builder.addLabel( "&Name:", // Mnemonic is 'N' cc1.xy(1, 7), // sets instance 1 to (1, 7) nameField, cc2.xy(3, 7) // sets instance 2 to (3, 7) );
- Parameters:
textWithMnemonic
- the label's text - may contain an ampersand (&) to mark a mnemoniclabelConstraints
- the label's cell constraintscomponent
- the component to addcomponentConstraints
- the component's cell constraints- Returns:
- the added label
- Throws:
java.lang.IllegalArgumentException
- if the same cell constraints instance is used for the label and the component- See Also:
JLabel.setLabelFor(java.awt.Component)
,ComponentFactory
,DefaultFormBuilder
-
addROLabel
public final javax.swing.JLabel addROLabel(java.lang.String textWithMnemonic)
Adds a textual label intended for labeling read-only components to the form using the default constraints.addROLabel("Name:"); // No Mnemonic addROLabel("N&ame:"); // Mnemonic is 'a' addROLabel("Save &as:"); // Mnemonic is the second 'a' addROLabel("Look&&Feel:"); // No mnemonic, text is "look&feel"
- Parameters:
textWithMnemonic
- the label's text - may contain an ampersand (&) to mark a mnemonic- Returns:
- the new label
- Since:
- 1.3
- See Also:
ComponentFactory2
-
addROLabel
public final javax.swing.JLabel addROLabel(java.lang.String textWithMnemonic, CellConstraints constraints)
Adds a textual label intended for labeling read-only components to the form using the specified constraints.addROLabel("Name:", cc.xy(1, 1)); // No Mnemonic addROLabel("N&ame:", cc.xy(1, 1)); // Mnemonic is 'a' addROLabel("Save &as:", cc.xy(1, 1)); // Mnemonic is the second 'a' addROLabel("Look&&Feel:", cc.xy(1, 1)); // No mnemonic, text is "look&feel"
- Parameters:
textWithMnemonic
- the label's text - may contain an ampersand (&) to mark a mnemonicconstraints
- the label's cell constraints- Returns:
- the new label
- Since:
- 1.3
- See Also:
ComponentFactory2
-
addROLabel
public final javax.swing.JLabel addROLabel(java.lang.String textWithMnemonic, java.lang.String encodedConstraints)
Adds a textual label intended for labeling read-only components to the form using the specified constraints.addROLabel("Name:", "1, 1"); // No Mnemonic addROLabel("N&ame:", "1, 1"); // Mnemonic is 'a' addROLabel("Save &as:", "1, 1"); // Mnemonic is the second 'a' addROLabel("Look&&Feel:", "1, 1"); // No mnemonic, text is "look&feel"
- Parameters:
textWithMnemonic
- the label's text - may contain an ampersand (&) to mark a mnemonicencodedConstraints
- a string representation for the constraints- Returns:
- the new label
- Since:
- 1.3
- See Also:
ComponentFactory2
-
addROLabel
public final javax.swing.JLabel addROLabel(java.lang.String textWithMnemonic, CellConstraints labelConstraints, java.awt.Component component, CellConstraints componentConstraints)
Adds a label and component to the panel using the given cell constraints. Sets the given label as the component label usingJLabel.setLabelFor(java.awt.Component)
.Note: The
CellConstraints
objects for the label and the component must be different. Cell constraints are implicitly cloned by the FormLayout when added to the container. However, in this case you may be tempted to reuse aCellConstraints
object in the same way as with many other builder methods that require a singleCellConstraints
parameter. The pitfall is that the methodsCellConstraints.xy*(...)
just set the coordinates but do not create a new instance. And so the second invocation ofxy*(...)
overrides the settings performed in the first invocation before the object is cloned by theFormLayout
.Wrong:
builder.addROLabel( "&Name:", // Mnemonic is 'N' cc.xy(1, 7), // will be modified by the code below nameField, cc.xy(3, 7) // sets the single instance to (3, 7) );
Correct:// Using a single CellConstraints instance and cloning CellConstraints cc = new CellConstraints(); builder.addROLabel( "&Name:", (CellConstraints) cc.xy(1, 7).clone(), // cloned before the next modification nameField, cc.xy(3, 7) // sets this instance to (3, 7) ); // Using two CellConstraints instances CellConstraints cc1 = new CellConstraints(); CellConstraints cc2 = new CellConstraints(); builder.addROLabel( "&Name:", // Mnemonic is 'N' cc1.xy(1, 7), // sets instance 1 to (1, 7) nameField, cc2.xy(3, 7) // sets instance 2 to (3, 7) );
- Parameters:
textWithMnemonic
- the label's text - may contain an ampersand (&) to mark a mnemoniclabelConstraints
- the label's cell constraintscomponent
- the component to addcomponentConstraints
- the component's cell constraints- Returns:
- the added label
- Throws:
java.lang.IllegalArgumentException
- if the same cell constraints instance is used for the label and the component- Since:
- 1.3
- See Also:
JLabel.setLabelFor(java.awt.Component)
,ComponentFactory2
,DefaultFormBuilder
-
addTitle
public final javax.swing.JLabel addTitle(java.lang.String textWithMnemonic)
Adds a title label to the form using the default constraints.addTitle("Name"); // No mnemonic addTitle("N&ame"); // Mnemonic is 'a' addTitle("Save &as"); // Mnemonic is the second 'a' addTitle("Look&&Feel"); // No mnemonic, text is Look&Feel
- Parameters:
textWithMnemonic
- the title label's text - may contain an ampersand (&) to mark a mnemonic- Returns:
- the added title label
- See Also:
ComponentFactory
-
addTitle
public final javax.swing.JLabel addTitle(java.lang.String textWithMnemonic, CellConstraints constraints)
Adds a title label to the form using the specified constraints.addTitle("Name", cc.xy(1, 1)); // No mnemonic addTitle("N&ame", cc.xy(1, 1)); // Mnemonic is 'a' addTitle("Save &as", cc.xy(1, 1)); // Mnemonic is the second 'a' addTitle("Look&&Feel", cc.xy(1, 1)); // No mnemonic, text is Look&Feel
- Parameters:
textWithMnemonic
- the title label's text - may contain an ampersand (&) to mark a mnemonicconstraints
- the separator's cell constraints- Returns:
- the added title label
- See Also:
ComponentFactory
-
addTitle
public final javax.swing.JLabel addTitle(java.lang.String textWithMnemonic, java.lang.String encodedConstraints)
Adds a title label to the form using the specified constraints.addTitle("Name", "1, 1"); // No mnemonic addTitle("N&ame", "1, 1"); // Mnemonic is 'a' addTitle("Save &as", "1, 1"); // Mnemonic is the second 'a' addTitle("Look&&Feel", "1, 1"); // No mnemonic, text is Look&Feel
- Parameters:
textWithMnemonic
- the title label's text - may contain an ampersand (&) to mark a mnemonicencodedConstraints
- a string representation for the constraints- Returns:
- the added title label
- See Also:
ComponentFactory
-
addSeparator
public final javax.swing.JComponent addSeparator(java.lang.String textWithMnemonic)
Adds a titled separator to the form that spans all columns.addSeparator("Name"); // No Mnemonic addSeparator("N&ame"); // Mnemonic is 'a' addSeparator("Save &as"); // Mnemonic is the second 'a' addSeparator("Look&&Feel"); // No mnemonic, text is "look&feel"
- Parameters:
textWithMnemonic
- the separator label's text - may contain an ampersand (&) to mark a mnemonic- Returns:
- the added separator
-
addSeparator
public final javax.swing.JComponent addSeparator(java.lang.String textWithMnemonic, CellConstraints constraints)
Adds a titled separator to the form using the specified constraints.addSeparator("Name", cc.xy(1, 1)); // No Mnemonic addSeparator("N&ame", cc.xy(1, 1)); // Mnemonic is 'a' addSeparator("Save &as", cc.xy(1, 1)); // Mnemonic is the second 'a' addSeparator("Look&&Feel", cc.xy(1, 1)); // No mnemonic, text is "look&feel"
- Parameters:
textWithMnemonic
- the separator label's text - may contain an ampersand (&) to mark a mnemonicconstraints
- the separator's cell constraints- Returns:
- the added separator
-
addSeparator
public final javax.swing.JComponent addSeparator(java.lang.String textWithMnemonic, java.lang.String encodedConstraints)
Adds a titled separator to the form using the specified constraints.addSeparator("Name", "1, 1"); // No Mnemonic addSeparator("N&ame", "1, 1"); // Mnemonic is 'a' addSeparator("Save &as", "1, 1"); // Mnemonic is the second 'a' addSeparator("Look&&Feel", "1, 1"); // No mnemonic, text is "look&feel"
- Parameters:
textWithMnemonic
- the separator label's text - may contain an ampersand (&) to mark a mnemonicencodedConstraints
- a string representation for the constraints- Returns:
- the added separator
-
addSeparator
public final javax.swing.JComponent addSeparator(java.lang.String textWithMnemonic, int columnSpan)
Adds a titled separator to the form that spans the specified columns.addSeparator("Name", 3); // No Mnemonic addSeparator("N&ame", 3); // Mnemonic is 'a' addSeparator("Save &as", 3); // Mnemonic is the second 'a' addSeparator("Look&&Feel", 3); // No mnemonic, text is "look&feel"
- Parameters:
textWithMnemonic
- the separator label's text - may contain an ampersand (&) to mark a mnemoniccolumnSpan
- the number of columns the separator spans- Returns:
- the added separator
-
add
public final javax.swing.JLabel add(javax.swing.JLabel label, CellConstraints labelConstraints, java.awt.Component component, CellConstraints componentConstraints)
Adds a label and component to the panel using the given cell constraints. Sets the given label as the component label usingJLabel.setLabelFor(java.awt.Component)
.Note: The
CellConstraints
objects for the label and the component must be different. Cell constraints are implicitly cloned by theFormLayout
when added to the container. However, in this case you may be tempted to reuse aCellConstraints
object in the same way as with many other builder methods that require a singleCellConstraints
parameter. The pitfall is that the methodsCellConstraints.xy*(...)
just set the coordinates but do not create a new instance. And so the second invocation ofxy*(...)
overrides the settings performed in the first invocation before the object is cloned by theFormLayout
.Wrong:
CellConstraints cc = new CellConstraints(); builder.add( nameLabel, cc.xy(1, 7), // will be modified by the code below nameField, cc.xy(3, 7) // sets the single instance to (3, 7) );
Correct:// Using a single CellConstraints instance and cloning CellConstraints cc = new CellConstraints(); builder.add( nameLabel, (CellConstraints) cc.xy(1, 7).clone(), // cloned before the next modification nameField, cc.xy(3, 7) // sets this instance to (3, 7) ); // Using two CellConstraints instances CellConstraints cc1 = new CellConstraints(); CellConstraints cc2 = new CellConstraints(); builder.add( nameLabel, cc1.xy(1, 7), // sets instance 1 to (1, 7) nameField, cc2.xy(3, 7) // sets instance 2 to (3, 7) );
- Parameters:
label
- the label to addlabelConstraints
- the label's cell constraintscomponent
- the component to addcomponentConstraints
- the component's cell constraints- Returns:
- the added label
- Throws:
java.lang.IllegalArgumentException
- if the same cell constraints instance is used for the label and the component- See Also:
JLabel.setLabelFor(java.awt.Component)
,DefaultFormBuilder
-
getComponentFactory
public final ComponentFactory getComponentFactory()
Returns the builder's component factory. If no factory has been set before, it is lazily initialized using with an instance ofDefaultComponentFactory
.- Returns:
- the component factory
- See Also:
setComponentFactory(ComponentFactory)
-
setComponentFactory
public final void setComponentFactory(ComponentFactory newFactory)
Sets a new component factory.- Parameters:
newFactory
- the component factory to be set- See Also:
getComponentFactory()
-
add
public java.awt.Component add(java.awt.Component component, CellConstraints cellConstraints)
Adds a component to the panel using the given cell constraints. In addition to the superclass behavior, this implementation tracks the most recently added label, and associates it with the next added component that is applicable for being set as component for the label.- Overrides:
add
in classAbstractFormBuilder
- Parameters:
component
- the component to addcellConstraints
- the component's cell constraints- Returns:
- the added component
- See Also:
isLabelForFeatureEnabled()
,isLabelForApplicable(JLabel, Component)
-
isLabelForApplicable
protected boolean isLabelForApplicable(javax.swing.JLabel label, java.awt.Component component)
Checks and answers whether the given component shall be set as component for a previously added label usingJLabel.setLabelFor(Component)
. This default implementation checks whether the component is focusable, and - if a JComponent - whether it is already labeled by a JLabel. Subclasses may override.- Parameters:
label
- the candidate for labelingcomponent
component
- the component that could be labeled bylabel
- Returns:
- true if focusable, false otherwise
-
setLabelFor
protected void setLabelFor(javax.swing.JLabel label, java.awt.Component component)
Setslabel
as labeling label forcomponent
or an appropriate child. In case of a JScrollPane as given component, this default implementation labels the view of the scroll pane's viewport.- Parameters:
label
- the labeling labelcomponent
- the component to be labeled, or the parent of the labeled component
-
-