com.l2fprod.common.swing.plaf

Class LookAndFeelAddons

java.lang.Object

com.l2fprod.common.swing.plaf.LookAndFeelAddons

Direct Known Subclasses:

BasicLookAndFeelAddons

public class LookAndFeelAddons
extends Object

Provides additional pluggable UI for new components added by the library. By default, the library uses the pluggable UI returned by getBestMatchAddonClassName().

The default addon can be configured using the swing.addon system property as follow:

• on the command line, java -Dswing.addon=ADDONCLASSNAME ...
• at runtime and before using the library components System.getProperties().put("swing.addon", ADDONCLASSNAME);

The addon can also be installed directly by calling the setAddon(String)method. For example, to install the Windows addons, add the following statement LookAndFeelAddons.setAddon("com.l2fprod.common.swing.plaf.windows.WindowsLookAndFeelAddons");.

Author:

Frederic Lavigne

Constructor Summary

Constructors

Constructor and Description
LookAndFeelAddons()

Method Summary

Modifier and Type	Method and Description
static void	contribute(ComponentAddon component) Each new component added by the library will contribute its default UI classes, colors and fonts to the LookAndFeelAddons.
static LookAndFeelAddons	getAddon()
static String	getBestMatchAddonClassName() Based on the current look and feel (as returned by UIManager.getLookAndFeel()), this method returns the name of the closest LookAndFeelAddons to use.
static String	getSystemAddonClassName() Gets the addon best suited for the operating system where the virtual machine is running.
static ComponentUI	getUI(JComponent component, Class expectedUIClass) Workaround for IDE mixing up with classloaders and Applets environments.
void	initialize()
static boolean	isTrackingLookAndFeelChanges()
void	loadDefaults(Object[] keysAndValues) Adds the given defaults in UIManager.
static void	setAddon(Class addonClass)
static void	setAddon(LookAndFeelAddons addon)
static void	setAddon(String addonClassName)
static void	setTrackingLookAndFeelChanges(boolean tracking) If true, everytime the Swing look and feel is changed, the addon which best matches the current look and feel will be automatically selected.
static void	uncontribute(ComponentAddon component) Removes the contribution of the given addon
void	uninitialize()
void	unloadDefaults(Object[] keysAndValues)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LookAndFeelAddons

public LookAndFeelAddons()

Method Detail

initialize

public void initialize()

uninitialize

public void uninitialize()

loadDefaults

public void loadDefaults(Object[] keysAndValues)

Adds the given defaults in UIManager. Note: the values are added only if they do not exist in the existing look and feel defaults. This makes it possible for look and feel implementors to override library defaults. Note: the array is traversed in reverse order. If a key is found twice in the array, the key/value with the highest position in the array gets precedence over the other key in the array

Parameters:

keysAndValues -

unloadDefaults

public void unloadDefaults(Object[] keysAndValues)

setAddon

public static void setAddon(String addonClassName)
                     throws InstantiationException,
                            IllegalAccessException,
                            ClassNotFoundException

Throws:

InstantiationException

IllegalAccessException

ClassNotFoundException

setAddon

public static void setAddon(Class addonClass)
                     throws InstantiationException,
                            IllegalAccessException

Throws:

InstantiationException

IllegalAccessException

setAddon

public static void setAddon(LookAndFeelAddons addon)

getAddon

public static LookAndFeelAddons getAddon()

getBestMatchAddonClassName

public static String getBestMatchAddonClassName()

Based on the current look and feel (as returned by UIManager.getLookAndFeel()), this method returns the name of the closest LookAndFeelAddons to use.

Returns:

the addon matching the currently installed look and feel

getSystemAddonClassName

public static String getSystemAddonClassName()

Gets the addon best suited for the operating system where the virtual machine is running.

Returns:

the addon matching the native operating system platform.

contribute

public static void contribute(ComponentAddon component)

Each new component added by the library will contribute its default UI classes, colors and fonts to the LookAndFeelAddons. See ComponentAddon.

Parameters:

component -

uncontribute

public static void uncontribute(ComponentAddon component)

Removes the contribution of the given addon

Parameters:

component -

getUI

public static ComponentUI getUI(JComponent component,
                                Class expectedUIClass)

Workaround for IDE mixing up with classloaders and Applets environments. Consider this method as API private. It must not be called directly.

Parameters:

component -

expectedUIClass -

Returns:

an instance of expectedUIClass

setTrackingLookAndFeelChanges

public static void setTrackingLookAndFeelChanges(boolean tracking)

If true, everytime the Swing look and feel is changed, the addon which best matches the current look and feel will be automatically selected.

Parameters:

tracking - true to automatically update the addon, false to not automatically track the addon. Defaults to false.

See Also:

getBestMatchAddonClassName()

isTrackingLookAndFeelChanges

public static boolean isTrackingLookAndFeelChanges()

Returns:

true if the addon will be automatically change to match the current look and feel

See Also:

setTrackingLookAndFeelChanges(boolean)