A multiplexing look and feel that allows more than one UI * to be associated with a component at the same time. * The primary look and feel is called * the default look and feel, * and the other look and feels are called auxiliary. *
* * For further information, see * Using the * Multiplexing Look and Feel. * *
* Warning:
* Serialized objects of this class will not be compatible with
* future Swing releases. The current serialization support is
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeansTM
* has been added to the java.beans package.
* Please see {@link java.beans.XMLEncoder}.
*
* @see UIManager#addAuxiliaryLookAndFeel
* @see javax.swing.plaf.multi
*
* @author Willie Walker
*/
public class MultiLookAndFeel extends LookAndFeel {
//////////////////////////////
// LookAndFeel methods
//////////////////////////////
/**
* Returns a string, suitable for use in menus,
* that identifies this look and feel.
*
* @return a string such as "Multiplexing Look and Feel"
*/
public String getName() {
return "Multiplexing Look and Feel";
}
/**
* Returns a string, suitable for use by applications/services,
* that identifies this look and feel.
*
* @return "Multiplex"
*/
public String getID() {
return "Multiplex";
}
/**
* Returns a one-line description of this look and feel.
*
* @return a descriptive string such as "Allows multiple UI instances per component instance"
*/
public String getDescription() {
return "Allows multiple UI instances per component instance";
}
/**
* Returns false;
* this look and feel is not native to any platform.
*
* @return false
*/
public boolean isNativeLookAndFeel() {
return false;
}
/**
* Returns true;
* every platform permits this look and feel.
*
* @return true
*/
public boolean isSupportedLookAndFeel() {
return true;
}
/**
* Creates, initializes, and returns
* the look and feel specific defaults.
* For this look and feel,
* the defaults consist solely of
* mappings of UI class IDs
* (such as "ButtonUI")
* to ComponentUI class names
* (such as "javax.swing.plaf.multi.MultiButtonUI").
*
* @return an initialized UIDefaults object
* @see javax.swing.JComponent#getUIClassID
*/
public UIDefaults getDefaults() {
String packageName = "javax.swing.plaf.multi.Multi";
Object[] uiDefaults = {
"ButtonUI", packageName + "ButtonUI",
"CheckBoxMenuItemUI", packageName + "MenuItemUI",
"CheckBoxUI", packageName + "ButtonUI",
"ColorChooserUI", packageName + "ColorChooserUI",
"ComboBoxUI", packageName + "ComboBoxUI",
"DesktopIconUI", packageName + "DesktopIconUI",
"DesktopPaneUI", packageName + "DesktopPaneUI",
"EditorPaneUI", packageName + "TextUI",
"FileChooserUI", packageName + "FileChooserUI",
"FormattedTextFieldUI", packageName + "TextUI",
"InternalFrameUI", packageName + "InternalFrameUI",
"LabelUI", packageName + "LabelUI",
"ListUI", packageName + "ListUI",
"MenuBarUI", packageName + "MenuBarUI",
"MenuItemUI", packageName + "MenuItemUI",
"MenuUI", packageName + "MenuItemUI",
"OptionPaneUI", packageName + "OptionPaneUI",
"PanelUI", packageName + "PanelUI",
"PasswordFieldUI", packageName + "TextUI",
"PopupMenuSeparatorUI", packageName + "SeparatorUI",
"PopupMenuUI", packageName + "PopupMenuUI",
"ProgressBarUI", packageName + "ProgressBarUI",
"RadioButtonMenuItemUI", packageName + "MenuItemUI",
"RadioButtonUI", packageName + "ButtonUI",
"RootPaneUI", packageName + "RootPaneUI",
"ScrollBarUI", packageName + "ScrollBarUI",
"ScrollPaneUI", packageName + "ScrollPaneUI",
"SeparatorUI", packageName + "SeparatorUI",
"SliderUI", packageName + "SliderUI",
"SpinnerUI", packageName + "SpinnerUI",
"SplitPaneUI", packageName + "SplitPaneUI",
"TabbedPaneUI", packageName + "TabbedPaneUI",
"TableHeaderUI", packageName + "TableHeaderUI",
"TableUI", packageName + "TableUI",
"TextAreaUI", packageName + "TextUI",
"TextFieldUI", packageName + "TextUI",
"TextPaneUI", packageName + "TextUI",
"ToggleButtonUI", packageName + "ButtonUI",
"ToolBarSeparatorUI", packageName + "SeparatorUI",
"ToolBarUI", packageName + "ToolBarUI",
"ToolTipUI", packageName + "ToolTipUI",
"TreeUI", packageName + "TreeUI",
"ViewportUI", packageName + "ViewportUI",
};
UIDefaults table = new MultiUIDefaults(uiDefaults.length / 2, 0.75f);
table.putDefaults(uiDefaults);
return table;
}
///////////////////////////////
// Utility methods for the UI's
///////////////////////////////
/**
* Creates the ComponentUI objects
* required to present
* the target component,
* placing the objects in the uis vector and
* returning the
* ComponentUI object
* that best represents the component's UI.
* This method finds the ComponentUI objects
* by invoking
* getDefaults().getUI(target) on each
* default and auxiliary look and feel currently in use.
* The first UI object this method adds
* to the uis vector
* is for the default look and feel.
*
* This method is invoked by the createUI method
* of MultiXxxxUI classes.
*
* @param mui the ComponentUI object
* that represents the complete UI
* for the target component;
* this should be an instance
* of one of the MultiXxxxUI classes
* @param uis a Vector;
* generally this is the uis field
* of the mui argument
* @param target a component whose UI is represented by mui
*
* @return mui if the component has any auxiliary UI objects;
* otherwise, returns the UI object for the default look and feel
* or null if the default UI object couldn't be found
*
* @see javax.swing.UIManager#getAuxiliaryLookAndFeels
* @see javax.swing.UIDefaults#getUI
* @see MultiButtonUI#uis
* @see MultiButtonUI#createUI
*/
public static ComponentUI createUIs(ComponentUI mui,
Vector uis,
JComponent target) {
ComponentUI ui;
// Make sure we can at least get the default UI
//
ui = UIManager.getDefaults().getUI(target);
if (ui != null) {
uis.addElement(ui);
LookAndFeel[] auxiliaryLookAndFeels;
auxiliaryLookAndFeels = UIManager.getAuxiliaryLookAndFeels();
if (auxiliaryLookAndFeels != null) {
for (int i = 0; i < auxiliaryLookAndFeels.length; i++) {
ui = auxiliaryLookAndFeels[i].getDefaults().getUI(target);
if (ui != null) {
uis.addElement(ui);
}
}
}
} else {
return null;
}
// Don't bother returning the multiplexing UI if all we did was
// get a UI from just the default look and feel.
//
if (uis.size() == 1) {
return (ComponentUI) uis.elementAt(0);
} else {
return mui;
}
}
/**
* Creates an array,
* populates it with UI objects from the passed-in vector,
* and returns the array.
* If uis is null,
* this method returns an array with zero elements.
* If uis is an empty vector,
* this method returns null.
* A run-time error occurs if any objects in the uis vector
* are not of type ComponentUI.
*
* @param uis a vector containing ComponentUI objects
* @return an array equivalent to the passed-in vector
*
*/
protected static ComponentUI[] uisToArray(Vector uis) {
if (uis == null) {
return new ComponentUI[0];
} else {
int count = uis.size();
if (count > 0) {
ComponentUI[] u = new ComponentUI[count];
for (int i = 0; i < count; i++) {
u[i] = (ComponentUI)uis.elementAt(i);
}
return u;
} else {
return null;
}
}
}
}
/**
* We want the Multiplexing LookAndFeel to be quiet and fallback
* gracefully if it cannot find a UI. This class overrides the
* getUIError method of UIDefaults, which is the method that
* emits error messages when it cannot find a UI class in the
* LAF.
*/
class MultiUIDefaults extends UIDefaults {
MultiUIDefaults(int initialCapacity, float loadFactor) {
super(initialCapacity, loadFactor);
}
protected void getUIError(String msg) {
System.err.println("Multiplexing LAF: " + msg);
}
}