|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectcom.jgoodies.forms.factories.DefaultComponentFactory
public class DefaultComponentFactory
A singleton implementation of the ComponentFactory interface
that creates UI components as required by the
PanelBuilder.
The texts used in methods #createLabel(String) and
#createTitle(String) 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".
| Constructor Summary | |
|---|---|
DefaultComponentFactory()
|
|
| Method Summary | |
|---|---|
JButton |
createButton(Action action)
Creates and returns a button that is bound to the given Action. |
JLabel |
createHeaderLabel(String markedText)
Creates and returns a label intended for pane headers that uses a larger font than the control font and a special foreground color. |
JLabel |
createLabel(String textWithMnemonic)
Creates and returns a label with an optional mnemonic. |
JLabel |
createReadOnlyLabel(String textWithMnemonic)
Creates and returns a label with an optional mnemonic that is intended to label a read-only component. |
JComponent |
createSeparator(JLabel label)
Creates and returns a labeled separator. |
JComponent |
createSeparator(String textWithMnemonic)
Creates and returns a labeled separator with the label in the left-hand side. |
JComponent |
createSeparator(String textWithMnemonic,
int alignment)
Creates and returns a labeled separator. |
JLabel |
createTitle(String textWithMnemonic)
Creates and returns a title label that uses the foreground color and font of a TitledBorder. |
static DefaultComponentFactory |
getInstance()
Returns the sole instance of this factory class. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
public DefaultComponentFactory()
| Method Detail |
|---|
public static DefaultComponentFactory getInstance()
public JLabel createLabel(String textWithMnemonic)
createLabel("Name"); // No mnemonic
createLabel("N&ame"); // Mnemonic is 'a'
createLabel("Save &as"); // Mnemonic is the second 'a'
createLabel("Look&&Feel"); // No mnemonic, text is Look&Feel
createLabel in interface ComponentFactorytextWithMnemonic - the label's text -
may contain an ampersand (&) to mark a mnemonic
public JLabel createReadOnlyLabel(String textWithMnemonic)
createReadOnlyLabel("Name"); // No mnemonic
createReadOnlyLabel("N&ame"); // Mnemonic is 'a'
createReadOnlyLabel("Save &as"); // Mnemonic is the second 'a'
createReadOnlyLabel("Look&&Feel"); // No mnemonic, text is Look&Feel
createReadOnlyLabel in interface ComponentFactorytextWithMnemonic - the label's text -
may contain an ampersand (&) to mark a mnemonic
public JButton createButton(Action action)
JGButton is bound to some custom Action properties.
This default implementation just returns a JButton.
createButton in interface ComponentFactoryaction - provides [bound] visual properties for the button
public JLabel createTitle(String textWithMnemonic)
TitledBorder.
createTitle("Name"); // No mnemonic
createTitle("N&ame"); // Mnemonic is 'a'
createTitle("Save &as"); // Mnemonic is the second 'a'
createTitle("Look&&Feel"); // No mnemonic, text is Look&Feel
createTitle in interface ComponentFactorytextWithMnemonic - the label's text -
may contain an ampersand (&) to mark a mnemonic
public JLabel createHeaderLabel(String markedText)
ComponentFactory
If the label text is marked with the mnemonic marker '&',
the mnemonic and mnemonic index will be configured.
For example if markedText is "&Charge Codes", the text
will be set to "Charge Codes", the mnemonic is 'C', and the
mnemonic index is 0.
A simple implementation may just delegate to
ComponentFactory.createTitle(String).
createHeaderLabel in interface ComponentFactorymarkedText - the label text with optional mnemonic marker
public JComponent createSeparator(String textWithMnemonic)
TitledBorder.
createSeparator("Name"); // No mnemonic
createSeparator("N&ame"); // Mnemonic is 'a'
createSeparator("Save &as"); // Mnemonic is the second 'a'
createSeparator("Look&&Feel"); // No mnemonic, text is Look&Feel
textWithMnemonic - the label's text -
may contain an ampersand (&) to mark a mnemonic
public JComponent createSeparator(String textWithMnemonic,
int alignment)
TitledBorder.
final int LEFT = SwingConstants.LEFT;
createSeparator("Name", LEFT); // No mnemonic
createSeparator("N&ame", LEFT); // Mnemonic is 'a'
createSeparator("Save &as", LEFT); // Mnemonic is the second 'a'
createSeparator("Look&&Feel", LEFT); // No mnemonic, text is Look&Feel
createSeparator in interface ComponentFactorytextWithMnemonic - the label's text -
may contain an ampersand (&) to mark a mnemonicalignment - text alignment, one of SwingConstants.LEFT,
SwingConstants.CENTER, SwingConstants.RIGHT
public JComponent createSeparator(JLabel label)
TitledBorder.
The label's position is determined by the label's horizontal alignment,
which must be one of:
SwingConstants.LEFT,
SwingConstants.CENTER,
SwingConstants.RIGHT.
TODO: Since this method has been marked public in version 1.0.6, we need to precisely describe the semantic of this method.
TODO: Check if we can relax the constraint for the label alignment and also accept LEADING and TRAILING.
label - the title label component
NullPointerException - if the label is null
IllegalArgumentException - if the label's horizontal alignment
is not one of: SwingConstants.LEFT,
SwingConstants.CENTER,
SwingConstants.RIGHT.
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||