org.jdesktop.swingx.plaf.AbstractComponentAddon Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of swingx-all Show documentation
Show all versions of swingx-all Show documentation
Fork of the inactive swingx-all library
/*
* $Id: AbstractComponentAddon.java 4047 2011-07-19 18:51:12Z kschaefe $
*
* Copyright 2004 Sun Microsystems, Inc., 4150 Network Circle,
* Santa Clara, California 95054, U.S.A. All rights reserved.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
package org.jdesktop.swingx.plaf;
import org.jdesktop.swingx.plaf.linux.LinuxLookAndFeelAddons;
import org.jdesktop.swingx.plaf.macosx.MacOSXLookAndFeelAddons;
import org.jdesktop.swingx.plaf.metal.MetalLookAndFeelAddons;
import org.jdesktop.swingx.plaf.motif.MotifLookAndFeelAddons;
import org.jdesktop.swingx.plaf.nimbus.NimbusLookAndFeelAddons;
import org.jdesktop.swingx.plaf.windows.WindowsLookAndFeelAddons;
import javax.swing.UIManager;
/**
* Ease the work of creating an addon for a component.
*
* @author Frederic Lavigne
* @author Karl Schaefer
*/
@SuppressWarnings("nls")
public abstract class AbstractComponentAddon implements ComponentAddon {
private final String name;
protected AbstractComponentAddon(String name) {
this.name = name;
}
@Override
public final String getName() {
return name;
}
@Override
public void initialize(LookAndFeelAddons addon) {
addon.loadDefaults(getDefaults(addon));
}
@Override
public void uninitialize(LookAndFeelAddons addon) {
// commented after Issue 446. Maybe addon should keep track of its
// added defaults to correctly remove them on uninitialize
// addon.unloadDefaults(getDefaults(addon));
}
/**
* Adds default key/value pairs to the given list.
*
* @param addon
* @param defaults
*/
protected void addBasicDefaults(LookAndFeelAddons addon, DefaultsList defaults) {
}
/**
* Default implementation calls
* {@link #addBasicDefaults(LookAndFeelAddons, DefaultsList)}
*
* @param addon
* @param defaults
*/
protected void addMacDefaults(LookAndFeelAddons addon, DefaultsList defaults) {
addBasicDefaults(addon, defaults);
}
/**
* Default implementation calls
* {@link #addBasicDefaults(LookAndFeelAddons, DefaultsList)}
*
* @param addon
* @param defaults
*/
protected void addMetalDefaults(LookAndFeelAddons addon, DefaultsList defaults) {
addBasicDefaults(addon, defaults);
}
/**
* Default implementation calls
* {@link #addBasicDefaults(LookAndFeelAddons, DefaultsList)}
*
* @param addon
* @param defaults
*/
protected void addMotifDefaults(LookAndFeelAddons addon, DefaultsList defaults) {
addBasicDefaults(addon, defaults);
}
/**
* Default implementation calls
* {@link #addBasicDefaults(LookAndFeelAddons, DefaultsList)}
*
* @param addon
* @param defaults
*/
protected void addWindowsDefaults(LookAndFeelAddons addon, DefaultsList defaults) {
addBasicDefaults(addon, defaults);
}
/**
* Default implementation calls
* {@link #addBasicDefaults(LookAndFeelAddons, DefaultsList)}
*
* @param addon
* @param defaults
*/
protected void addLinuxDefaults(LookAndFeelAddons addon, DefaultsList defaults) {
addBasicDefaults(addon, defaults);
}
/**
* Default implementation calls
* {@link #addBasicDefaults(LookAndFeelAddons, DefaultsList)}
*
* @param addon
* @param defaults
*/
protected void addNimbusDefaults(LookAndFeelAddons addon, DefaultsList defaults) {
addBasicDefaults(addon, defaults);
}
/**
* Gets the defaults for the given addon.
*
* Based on the addon, it calls
* {@link #addMacDefaults(LookAndFeelAddons, DefaultsList)} if isMac() or
* {@link #addMetalDefaults(LookAndFeelAddons, DefaultsList)} if isMetal()
* or {@link #addMotifDefaults(LookAndFeelAddons, DefaultsList)} if
* isMotif() or {@link #addWindowsDefaults(LookAndFeelAddons, DefaultsList)}
* if isWindows() or
* {@link #addBasicDefaults(LookAndFeelAddons, DefaultsList)} if none of the
* above was called.
*
* @param addon
* @return an array of key/value pairs. For example:
*
*
* Object[] uiDefaults = { "Font", new Font("Dialog", Font.BOLD, 12), "Color",
* Color.red, "five", new Integer(5) };
*
*/
private Object[] getDefaults(LookAndFeelAddons addon) {
DefaultsList defaults = new DefaultsList();
if (isWindows(addon)) {
addWindowsDefaults(addon, defaults);
} else if (isMetal(addon)) {
addMetalDefaults(addon, defaults);
} else if (isMac(addon)) {
addMacDefaults(addon, defaults);
} else if (isMotif(addon)) {
addMotifDefaults(addon, defaults);
// PENDING JW: the separation line here looks fishy
// what about Nimbus on Linux systems?
} else if (isLinux(addon)) {
addLinuxDefaults(addon, defaults);
} else if (isNimbus(addon)) {
addNimbusDefaults(addon, defaults);
} else {
// at least add basic defaults
addBasicDefaults(addon, defaults);
}
return defaults.toArray();
}
//
// Helper methods to make ComponentAddon developer life easier
//
/**
* @return true if the addon is the Windows addon or its subclasses
*/
protected boolean isWindows(LookAndFeelAddons addon) {
return addon instanceof WindowsLookAndFeelAddons;
}
/**
* @return true if the addon is the Metal addon or its subclasses
*/
protected boolean isMetal(LookAndFeelAddons addon) {
return addon instanceof MetalLookAndFeelAddons;
}
/**
* @return true if the addon is the Mac OS X addon or its subclasses
*/
protected boolean isMac(LookAndFeelAddons addon) {
return addon instanceof MacOSXLookAndFeelAddons;
}
/**
* @return true if the addon is the Motif addon or its subclasses
*/
protected boolean isMotif(LookAndFeelAddons addon) {
return addon instanceof MotifLookAndFeelAddons;
}
/**
* @return true if the current look and feel is Linux
*/
protected boolean isLinux(LookAndFeelAddons addon) {
return addon instanceof LinuxLookAndFeelAddons;
}
/**
* @return true if the current look and feel is Nimbus
*/
protected boolean isNimbus(LookAndFeelAddons addon) {
return addon instanceof NimbusLookAndFeelAddons;
}
/**
* @return true if the current look and feel is one of JGoodies Plastic l&fs
*/
protected boolean isPlastic() {
return UIManager.getLookAndFeel().getClass().getName().contains("Plastic");
}
/**
* @return true if the current look and feel is Synth l&f
*/
protected boolean isSynth() {
return UIManager.getLookAndFeel().getClass().getName().contains("ynth");
}
}