com.jgoodies.forms.factories

Interface ComponentFactory

public interface ComponentFactory

An interface that defines the factory methods as used by the {@link com.jgoodies.forms.builder.PanelBuilder} and its subclasses.

The String arguments passed to the methods #createLabel(String), #createTitle(String), and #createSeparator(String, int) 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".

Version: $Revision: 1.2 $

Author: Karsten Lentzsch

Method Summary
JLabel	createLabel(String textWithMnemonic) Creates and returns a label with an optional mnemonic. 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
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`. 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

Method Summary

JLabel

createLabel(String textWithMnemonic)

Creates and returns a label with an optional mnemonic.

 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

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.

 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

Method Detail

createLabel

public JLabel createLabel(String textWithMnemonic)

Creates and returns a label with an optional mnemonic.

 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

Parameters: textWithMnemonic the label's text - may contain an ampersand (&) to mark a mnemonic

Returns: an label with optional mnemonic

createSeparator

public JComponent createSeparator(String textWithMnemonic, int alignment)

Creates and returns a labeled separator. Useful to separate paragraphs in a panel, which is often a better choice than a 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

Parameters: textWithMnemonic the label's text - may contain an ampersand (&) to mark a mnemonic alignment text alignment, one of SwingConstants.LEFT, SwingConstants.CENTER, SwingConstants.RIGHT

Returns: a title label with separator on the side

createTitle

public JLabel createTitle(String textWithMnemonic)

Creates and returns a title label that uses the foreground color and font of a 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

Parameters: textWithMnemonic the label's text - may contain an ampersand (&) to mark a mnemonic

Returns: an emphasized title label