Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
java.lang.Object
com.jgoodies.forms.builder.AbstractFormBuilder
com.jgoodies.forms.builder.PanelBuilder
com.jgoodies.forms.builder.I15dPanelBuilder
public class I15dPanelBuilder
extends PanelBuilder
FormLayout
to lay out JPanel
s. In addition to its superclass
PanelBuilder
this class provides convenience behavior to map
resource keys to their associated internationalized (i15d) strings
when adding labels, titles and titled separators.
The localized texts used in methods #addI15dLabel
and #addI15dTitle
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".
ResourceBundle
Constructor Summary | |
| |
| |
|
Method Summary | |
JLabel |
|
JLabel |
|
JLabel |
|
JLabel |
|
JComponent |
|
JComponent |
|
JLabel |
|
protected String |
|
Methods inherited from class com.jgoodies.forms.builder.PanelBuilder | |
add , addLabel , addLabel , addLabel , addLabel , addSeparator , addSeparator , addSeparator , addSeparator , addTitle , addTitle , addTitle , getComponentFactory , getPanel , setBorder , setComponentFactory , setDefaultDialogBorder |
public I15dPanelBuilder(JPanel panel, FormLayout layout, ResourceBundle bundle)
Deprecated. Replaced by
I15dPanelBuilder(FormLayout,ResourceBundle,JPanel)
.Constructs an instance ofI15dPanelBuilder
for the given FormLayout and layout container.
- Parameters:
panel
- the layout containerlayout
- theFormLayout
used to layout the containerbundle
- theResourceBundle
used to lookup i15d strings
public I15dPanelBuilder(FormLayout layout, ResourceBundle bundle)
Constructs an instance ofI15dPanelBuilder
for the given layout. Uses an instance ofJPanel
as layout container.
- Parameters:
layout
- the form layout used to layout the containerbundle
- the resource bundle used to lookup i15d strings
public I15dPanelBuilder(FormLayout layout, ResourceBundle bundle, JPanel panel)
Constructs an instance ofI15dPanelBuilder
for the given FormLayout and layout container.
- Parameters:
layout
- theFormLayout
used to layout the containerbundle
- theResourceBundle
used to lookup i15d stringspanel
- the layout container
public final JLabel add15dTitle(String resourceKey, String encodedConstraints)
Adds a title to the form using the specified constraints.
- Parameters:
resourceKey
- the resource key for the separator titelencodedConstraints
- a string representation for the constraints
- Returns:
- the added title label
public final JLabel addI15dLabel(String resourceKey, String encodedConstraints)
Adds an internationalized (i15d) textual label to the form using the specified constraints.
- Parameters:
resourceKey
- the resource key for the label's textencodedConstraints
- a string representation for the constraints
- Returns:
- the added label
public final JLabel addI15dLabel(String resourceKey, CellConstraints constraints)
Adds an internationalized (i15d) textual label to the form using the specified constraints.
- Parameters:
resourceKey
- the resource key for the label's textconstraints
- the label's cell constraints
- Returns:
- the added label
public final JLabel addI15dLabel(String resourceKey, CellConstraints labelConstraints, Component component, CellConstraints componentConstraints)
Adds an internationalized (i15d) label and component to the panel using the given cell constraints. Sets the label as the component label usingJLabel.setLabelFor(java.awt.Component)
. Note: TheCellConstraints
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.add("name.key", cc.xy(1, 7), // will be modified by the code below nameField, cc.xy(3, 7) // sets the single instance to (3, 7) );Correct:builder.add("name.key", cc.xy(1, 7).clone(), // cloned before the next modification nameField, cc.xy(3, 7) // sets this instance to (3, 7) );
- Parameters:
resourceKey
- the resource key for the labellabelConstraints
- the label's cell constraintscomponent
- the component to addcomponentConstraints
- the component's cell constraints
- Returns:
- the added label
- See Also:
JLabel.setLabelFor(java.awt.Component)
public final JComponent addI15dSeparator(String resourceKey, String encodedConstraints)
Adds an internationalized (i15d) titled separator to the form using the specified constraints.
- Parameters:
resourceKey
- the resource key for the separator titelencodedConstraints
- a string representation for the constraints
- Returns:
- the added titled separator
public final JComponent addI15dSeparator(String resourceKey, CellConstraints constraints)
Adds an internationalized (i15d) titled separator to the form using the specified constraints.
- Parameters:
resourceKey
- the resource key for the separator titleconstraints
- the separator's cell constraints
- Returns:
- the added titled separator
public final JLabel addI15dTitle(String resourceKey, CellConstraints constraints)
Adds a title to the form using the specified constraints.
- Parameters:
resourceKey
- the resource key for the separator titleconstraints
- the separator's cell constraints
- Returns:
- the added title label
protected String getI15dString(String resourceKey)
Looks up and returns the internationalized (i15d) string for the given resource key from theResourceBundle
.
- Parameters:
resourceKey
- the key to look for in the resource bundle
- Returns:
- the associated internationalized string, or the resource key itself in case of a missing resource