Package javax.swing.plaf.synth
SynthStyleFactory
. Both configuration options
require an understanding of the synth architecture, which is described below,
as well as an understanding of Swing's architecture.
Unless otherwise specified null is not a legal value to any of the methods
defined in the synth package and if passed in will result in a
NullPointerException
.
Synth
EachComponentUI
implementation in Synth associates
itself with one SynthStyle
per
Region
, most Components
only have one
Region
and therefore only one SynthStyle
. SynthStyle
is used to access all style related properties: fonts, colors
and other Component
properties. In addition SynthStyle
s are
used to obtain SynthPainter
s for painting the
background, border, focus and other portions of a Component
. The
ComponentUI
s obtain SynthStyle
s from a
SynthStyleFactory
. A SynthStyleFactory
can be provided directly by way of
SynthLookAndFeel.setStyleFactory(javax.swing.plaf.synth.SynthStyleFactory)
,
or indirectly by way of SynthLookAndFeel.load(java.io.InputStream, java.lang.Class<?>)
.
The following example uses the SynthLookAndFeel.load()
method to
configure a SynthLookAndFeel
and sets it as the current look and
feel:
SynthLookAndFeel laf = new SynthLookAndFeel();
laf.load(MyClass.class.getResourceAsStream("laf.xml"), MyClass.class);
UIManager.setLookAndFeel(laf);
Many JComponent
s are broken down into smaller pieces and identified
by the type safe enumeration in Region
. For
example, a JTabbedPane
consists of a Region
for the
JTabbedPane
(Region.TABBED_PANE
), the
content area (Region.TABBED_PANE_CONTENT
), the
area behind the tabs
(Region.TABBED_PANE_TAB_AREA
), and the tabs
(Region.TABBED_PANE_TAB
). Each
Region
of each JComponent
will have a SynthStyle
.
This allows you to customize individual pieces of each region of each
JComponent
.
Many of the Synth methods take a SynthContext
.
This is used to provide information about the current Component
and
includes: the SynthStyle
associated with the
current Region
, the state of the
Component
as a bitmask (refer to
SynthConstants
for the valid states), and a
Region
identifying the portion of the
Component
being painted.
All text rendering by non-JTextComponent
s is delegated to a
SynthGraphicsUtils
, which is obtained using
the SynthStyle
method
SynthStyle.getGraphicsUtils(javax.swing.plaf.synth.SynthContext)
. You can customize
text rendering by supplying your own
SynthGraphicsUtils
.
Notes on specific components
JTree
Synth provides a region for the cells of a tree:Region.TREE_CELL
. To specify the colors of the
renderer you'll want to provide a style for the
TREE_CELL
region. The following illustrates this:
<style id="treeCellStyle">
<opaque value="TRUE"/>
<state>
<color value="WHITE" type="TEXT_FOREGROUND"/>
<color value="RED" type="TEXT_BACKGROUND"/>
</state>
<state value="SELECTED">
<color value="RED" type="TEXT_FOREGROUND"/>
<color value="WHITE" type="BACKGROUND"/>
</state>
</style>
<bind style="treeCellStyle" type="region" key="TreeCell"/>
This specifies a color combination of red on white, when selected, and white on red when not selected. To see the background you need to specify that labels are not opaque. The following XML fragment does that:
<style id="labelStyle">
<opaque value="FALSE"/>
</style>
<bind style="labelStyle" type="region" key="Label"/>
JList and JTable
The colors that the renderers for JList and JTable use are specified by way of the list and table Regions. The following XML fragment illustrates how to specify red on white, when selected, and white on red when not selected:
<style id="style">
<opaque value="TRUE"/>
<state>
<color value="WHITE" type="TEXT_FOREGROUND"/>
<color value="RED" type="TEXT_BACKGROUND"/>
<color value="RED" type="BACKGROUND"/>
</state>
<state value="SELECTED">
<color value="RED" type="TEXT_FOREGROUND"/>
<color value="WHITE" type="TEXT_BACKGROUND"/>
</state>
</style>
<bind style="style" type="region" key="Table"/>
<bind style="style" type="region" key="List"/>
-
ClassDescriptionA typesafe enumeration of colors that can be fetched from a style.A distinct rendering area of a Swing component.Provides the Synth L&F UI delegate for
JButton
.Provides the Synth L&F UI delegate forJCheckBoxMenuItem
.Provides the Synth L&F UI delegate forJCheckBox
.Provides the Synth L&F UI delegate forJColorChooser
.Provides the Synth L&F UI delegate forJComboBox
.Constants used by Synth.An immutable transient object containing contextual information about aRegion
.Provides the Synth L&F UI delegate for a minimized internal frame on a desktop.Provides the Synth L&F UI delegate forJDesktopPane
.Provides the Synth L&F UI delegate forJEditorPane
.Provides the Synth L&F UI delegate forJFormattedTextField
.Wrapper for primitive graphics calls.An icon that is passed aSynthContext
.Provides the Synth L&F UI delegate forJInternalFrame
.Provides the Synth L&F UI delegate forJLabel
.Provides the Synth L&F UI delegate forJList
.SynthLookAndFeel provides the basis for creating a customized look and feel.Provides the Synth L&F UI delegate forJMenuBar
.Provides the Synth L&F UI delegate forJMenuItem
.Provides the Synth L&F UI delegate forJMenu
.Provides the Synth L&F UI delegate forJOptionPane
.SynthPainter
is used for painting portions ofJComponent
s.Provides the Synth L&F UI delegate forJPanel
.Provides the Synth L&F UI delegate forJPasswordField
.Provides the Synth L&F UI delegate forJPopupMenu
.Provides the Synth L&F UI delegate forJProgressBar
.Provides the Synth L&F UI delegate forJRadioButtonMenuItem
.Provides the Synth L&F UI delegate forJRadioButton
.Provides the Synth L&F UI delegate forJRootPane
.Provides the Synth L&F UI delegate forJScrollBar
.Provides the Synth L&F UI delegate forJScrollPane
.Provides the Synth L&F UI delegate forJSeparator
.Provides the Synth L&F UI delegate forJSlider
.Provides the Synth L&F UI delegate forJSpinner
.Provides the Synth L&F UI delegate forJSplitPane
.SynthStyle
is a set of style properties.Factory used for obtainingSynthStyle
s.Provides the Synth L&F UI delegate forJTabbedPane
.Provides the Synth L&F UI delegate forJTableHeader
.Provides the Synth L&F UI delegate forJTable
.Provides the look and feel for a plain text editor in the Synth look and feel.Provides the Synth L&F UI delegate forJTextField
.Provides the look and feel for a styled text editor in the Synth look and feel.Provides the Synth L&F UI delegate forJToggleButton
.Provides the Synth L&F UI delegate forJToolBar
.Provides the Synth L&F UI delegate forJToolTip
.Provides the Synth L&F UI delegate forJTree
.SynthUI is used to fetch the SynthContext for a particular Component.Provides the Synth L&F UI delegate forJViewport
.