:: JGOODIES Looks :: Professional Swing Look&Feels

:: 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.

(c) 2009 JGoodies