:: User's Guide :: Introduction ::
The JGoodies Looks distribution provides four Swing look&feel implementations.
This guide explains how to install and configure these looks.
Before You Start
To use the JGoodies look&feels add looks-x.x.x.jar to your user classpath.
Do not put the jar into the extension directory!
Learn why...
As an alternative, you can import the sources or extract the class files
from the JAR for inclusion in one of your application JARs.
Class References vs. Name References
There are two ways to work with the JGoodies l&f and optional settings:
1) You refer to JGoodies classes.
This is compile-time safe and less error-prone.
But it requires to import JGoodies classes; and so this can be used
only if you can ensure that the JGoodies Looks are in the classpath at runtime.
2) You can use names/strings.
If you are not sure whether the JGoodies Looks will be available at
runtime, you can choose the l&f and options using names.
UIManager vs. JGoodies Classes
You can either specify JGoodies options via the UIManager class
or via JGoodies classes, most noticably the Options class.
You can put values for specific keys in the UIManager.
This decouples your application code from the JGoodies implementations,
and so avoids the need to import JGoodies classes in your code.
This is the recommended way, if you cannot (easily) modify your code,
or if you are not allowed to import third party libraries.
Calling the JGoodies methods enables static compiler checks
and will be the preferred way to set options, if you have
full control over your application code.
Global vs. Look-Specific Settings
The JGoodies Windows L&F and the JGoodies Plastic L&F
introduce and share several optional settings. You can find
all global options in class com.jgoodies.looks.Options,
and look-specific settings in the particular LookAndFeel
subclasses: WindowsLookAndFeel, PlasticLookAndFeel,
Plastic3DLookAndFeel and PlasticXPLookAndFeel.
Optional Settings
The JGoodies l&fs introduce several optional l&f properties
and JComponent client properties that enable you to tweak your
application's visual appearance. You can find keys and/or accessors
to this optional behavior in class com.jgoodies.looks.Options.
The Simple Looks Demo uses several of these settings.
Beyond that, the JGoodies Looks Demo let's you play around with these options.
|