/*
* Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code 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 General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package javax.swing.plaf.multi;
import java.util.Vector;
import java.lang.reflect.Method;
import javax.swing.*;
import javax.swing.plaf.*;
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 JavaBeans
has been added to the java.beans package. Please see XMLEncoder.
Author: Willie Walker See Also:
/**
* <p>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 <em>default</em> look and feel,
* and the other look and feels are called <em>auxiliary</em>.
* <p>
*
* For further information, see
* <a href="doc-files/multi_tsc.html" target="_top">Using the
* Multiplexing Look and Feel.</a>
*
* <p>
* <strong>Warning:</strong>
* 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 JavaBeans
* has been added to the <code>java.beans</code> package.
* Please see {@link java.beans.XMLEncoder}.
*
* @see UIManager#addAuxiliaryLookAndFeel
* @see javax.swing.plaf.multi
*
* @author Willie Walker
*/
@SuppressWarnings("serial") // Same-version serialization only
public class MultiLookAndFeel extends LookAndFeel {
//////////////////////////////
// LookAndFeel methods
//////////////////////////////
Returns a string, suitable for use in menus,
that identifies this look and feel.
Returns: a string such as "Multiplexing Look and Feel"
/**
* 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.
Returns: "Multiplex"
/**
* 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.
Returns: a descriptive string such as "Allows multiple UI instances per component instance"
/**
* 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.
Returns: false
/**
* Returns <code>false</code>;
* this look and feel is not native to any platform.
*
* @return <code>false</code>
*/
public boolean isNativeLookAndFeel() {
return false;
}
Returns true;
every platform permits this look and feel.
Returns: true
/**
* Returns <code>true</code>;
* every platform permits this look and feel.
*
* @return <code>true</code>
*/
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").
See Also: Returns: an initialized UIDefaults object
/**
* 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 <code>ComponentUI</code> class names
* (such as "javax.swing.plaf.multi.MultiButtonUI").
*
* @return an initialized <code>UIDefaults</code> 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.
Params: - mui – the
ComponentUI object
that represents the complete UI
for the target component;
this should be an instance
of one of the MultiXxxxUI classes - uis – a
Vector;
generally this is the uis field
of the mui argument - target – a component whose UI is represented by
mui
See Also: Returns: 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
/**
* Creates the <code>ComponentUI</code> objects
* required to present
* the <code>target</code> component,
* placing the objects in the <code>uis</code> vector and
* returning the
* <code>ComponentUI</code> object
* that best represents the component's UI.
* This method finds the <code>ComponentUI</code> objects
* by invoking
* <code>getDefaults().getUI(target)</code> on each
* default and auxiliary look and feel currently in use.
* The first UI object this method adds
* to the <code>uis</code> vector
* is for the default look and feel.
* <p>
* This method is invoked by the <code>createUI</code> method
* of <code>MultiXxxxUI</code> classes.
*
* @param mui the <code>ComponentUI</code> object
* that represents the complete UI
* for the <code>target</code> component;
* this should be an instance
* of one of the <code>MultiXxxxUI</code> classes
* @param uis a <code>Vector</code>;
* generally this is the <code>uis</code> field
* of the <code>mui</code> argument
* @param target a component whose UI is represented by <code>mui</code>
*
* @return <code>mui</code> if the component has any auxiliary UI objects;
* otherwise, returns the UI object for the default look and feel
* or <code>null</code> 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<ComponentUI> 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 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.
Params: - uis – a vector containing
ComponentUI objects
Returns: an array equivalent to the passed-in vector
/**
* Creates an array,
* populates it with UI objects from the passed-in vector,
* and returns the array.
* If <code>uis</code> is null,
* this method returns an array with zero elements.
* If <code>uis</code> is an empty vector,
* this method returns <code>null</code>.
* A run-time error occurs if any objects in the <code>uis</code> vector
* are not of type <code>ComponentUI</code>.
*
* @param uis a vector containing <code>ComponentUI</code> objects
* @return an array equivalent to the passed-in vector
*
*/
protected static ComponentUI[] uisToArray(Vector<? extends ComponentUI> 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] = 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.
/**
* 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.
*/
@SuppressWarnings("serial") // Superclass is not serializable across versions
class MultiUIDefaults extends UIDefaults {
MultiUIDefaults(int initialCapacity, float loadFactor) {
super(initialCapacity, loadFactor);
}
protected void getUIError(String msg) {
System.err.println("Multiplexing LAF: " + msg);
}
}