Summary: Ctors | Methods | Protected Methods | Inherited Methods | [Expand All]

public class

MultiLookAndFeel

extends LookAndFeel

java.lang.Object
↳	javax.swing.LookAndFeel
	↳	javax.swing.plaf.multi.MultiLookAndFeel

Class Overview

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^TM has been added to the java.beans package. Please see XMLEncoder.

Summary

Public Constructors
	MultiLookAndFeel()

Public Methods
static ComponentUI	createUIs(ComponentUI mui, Vector uis, JComponent target) 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.
UIDefaults	getDefaults() Creates, initializes, and returns the look and feel specific defaults.
String	getDescription() Returns a one-line description of this look and feel.
String	getID() Returns a string, suitable for use by applications/services, that identifies this look and feel.
String	getName() Returns a string, suitable for use in menus, that identifies this look and feel.
boolean	isNativeLookAndFeel() Returns `false`; this look and feel is not native to any platform.
boolean	isSupportedLookAndFeel() Returns `true`; every platform permits this look and feel.

Protected Methods
static ComponentUI[]	uisToArray(Vector uis) Creates an array, populates it with UI objects from the passed-in vector, and returns the array.

[Expand]

Inherited Methods

From class javax.swing.LookAndFeel

UIDefaults	getDefaults() Returns the look and feel defaults.
abstract String	getDescription() Return a one line description of this look and feel implementation, e.g.
static Object	getDesktopPropertyValue(String systemPropertyName, Object fallbackValue) Returns the value of the specified system desktop property by invoking `Toolkit.getDefaultToolkit().getDesktopProperty()`.
Icon	getDisabledIcon(JComponent component, Icon icon) Returns an `Icon` with a disabled appearance.
Icon	getDisabledSelectedIcon(JComponent component, Icon icon) Returns an `Icon` for use by disabled components that are also selected.
abstract String	getID() Return a string that identifies this look and feel.
LayoutStyle	getLayoutStyle() Returns the `LayoutStyle` for this look and feel.
abstract String	getName() Return a short string that identifies this look and feel, e.g.
boolean	getSupportsWindowDecorations() Returns `true` if the `LookAndFeel` returned `RootPaneUI` instances support providing `Window` decorations in a `JRootPane`.
void	initialize() Initializes the look and feel.
static void	installBorder(JComponent c, String defaultBorderName) Convenience method for setting a component's border property with a value from the defaults.
static void	installColors(JComponent c, String defaultBgName, String defaultFgName) Convenience method for setting a component's foreground and background color properties with values from the defaults.
static void	installColorsAndFont(JComponent c, String defaultBgName, String defaultFgName, String defaultFontName) Convenience method for setting a component's foreground, background and font properties with values from the defaults.
static void	installProperty(JComponent c, String propertyName, Object propertyValue) Convenience method for installing a property with the specified name and value on a component if that property has not already been set by the developer.
abstract boolean	isNativeLookAndFeel() If the underlying platform has a "native" look and feel, and this is an implementation of it, return `true`.
abstract boolean	isSupportedLookAndFeel() Return `true` if the underlying platform supports and or permits this look and feel.
static void	loadKeyBindings(InputMap retMap, Object[] keys) Populates an `InputMap` with the specified bindings.
static ComponentInputMap	makeComponentInputMap(JComponent c, Object[] keys) Creates a `ComponentInputMapUIResource` from `keys`.
static Object	makeIcon(Class<?> baseClass, String gifFile) Creates and returns a `UIDefault.LazyValue` that loads an image.
static InputMap	makeInputMap(Object[] keys) Creates a `InputMapUIResource` from `keys`.
static KeyBinding[]	makeKeyBindings(Object[] keyBindingList) Convenience method for building an array of `KeyBindings`.
void	provideErrorFeedback(Component component) Invoked when the user attempts an invalid operation, such as pasting into an uneditable `JTextField` that has focus.
String	toString() Returns a string that displays and identifies this object's properties.
void	uninitialize() Uninitializes the look and feel.
static void	uninstallBorder(JComponent c) Convenience method for uninstalling a border.

From class java.lang.Object

Object	clone() Creates and returns a copy of this object.
boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
final Class<?>	getClass() Returns the runtime class of this `Object`.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait() Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.
final void	wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.

Public Constructors

public MultiLookAndFeel ()

Public Methods

public static ComponentUI createUIs (ComponentUI mui, Vector uis, JComponent target)

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.

Parameters

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`

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

public UIDefaults getDefaults ()

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").

Returns

an initialized UIDefaults object

public String getDescription ()

Returns a one-line description of this look and feel.

Returns

a descriptive string such as "Allows multiple UI instances per component instance"

public String getID ()

Returns a string, suitable for use by applications/services, that identifies this look and feel.

Returns

"Multiplex"

public String getName ()

Returns a string, suitable for use in menus, that identifies this look and feel.

Returns

a string such as "Multiplexing Look and Feel"

public boolean isNativeLookAndFeel ()

Returns false; this look and feel is not native to any platform.

Returns

false

public boolean isSupportedLookAndFeel ()

Returns true; every platform permits this look and feel.

Returns

true

Protected Methods

protected static ComponentUI[] uisToArray (Vector uis)

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.

Parameters

uis	a vector containing `ComponentUI` objects

Returns

an array equivalent to the passed-in vector

Classes

MultiLookAndFeel

Class Overview

See Also

Summary

Public Constructors

public MultiLookAndFeel ()

Public Methods

public static ComponentUI createUIs (ComponentUI mui, Vector uis, JComponent target)

Parameters

Returns

See Also

public UIDefaults getDefaults ()

Returns

See Also

public String getDescription ()

Returns

public String getID ()

Returns

public String getName ()

Returns

public boolean isNativeLookAndFeel ()

Returns

public boolean isSupportedLookAndFeel ()

Returns

Protected Methods

protected static ComponentUI[] uisToArray (Vector uis)

Parameters

Returns