javax.swing
Class UIDefaults

java.lang.Object   
  java.util.Dictionary   <K,V>
      java.util.Hashtable   <Object   ,Object   >
          javax.swing.UIDefaults

All Implemented Interfaces:

Serializable , Cloneable , Map <Object ,Object >

public class UIDefaults
extends Hashtable   <Object   ,Object   >

A table of defaults for Swing components. Applications can set/get default values via the UIManager.

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 .

See Also:

UIManager , Serialized Form

Nested Class Summary

static interface	UIDefaults.ActiveValue This class enables one to store an entry in the defaults table that's constructed each time it's looked up with one of the getXXX(key) methods.
static class	UIDefaults.LazyInputMap LazyInputMap will create a InputMap in its createValue method.
static interface	UIDefaults.LazyValue This class enables one to store an entry in the defaults table that isn't constructed until the first time it's looked up with one of the getXXX(key) methods.
static class	UIDefaults.ProxyLazyValue This class provides an implementation of LazyValue which can be used to delay loading of the Class for the instance to be created.

Constructor Summary

UIDefaults ()
Create an empty defaults table.

UIDefaults (Object [] keyValueList)
Create a defaults table initialized with the specified key/value pairs.

Method Summary

void	addPropertyChangeListener (PropertyChangeListener listener) Adds a PropertyChangeListener to the listener list.
void	addResourceBundle (String bundleName) Adds a resource bundle to the list of resource bundles that are searched for localized values.
protected void	firePropertyChange (String propertyName, Object oldValue, Object newValue) Support for reporting bound property changes.
Object	get (Object key) Returns the value for key.
Object	get (Object key, Locale l) Returns the value for key associated with the given locale.
boolean	getBoolean (Object key) If the value of key is boolean, return the boolean value, otherwise return false.
boolean	getBoolean (Object key, Locale l) If the value of key for the given Locale is boolean, return the boolean value, otherwise return false.
Border	getBorder (Object key) If the value of key is a Border return it, otherwise return null.
Border	getBorder (Object key, Locale l) If the value of key for the given Locale is a Border return it, otherwise return null.
Color	getColor (Object key) If the value of key is a Color return it, otherwise return null.
Color	getColor (Object key, Locale l) If the value of key for the given Locale is a Color return it, otherwise return null.
Locale	getDefaultLocale () Returns the default locale.
Dimension	getDimension (Object key) If the value of key is a Dimension return it, otherwise return null.
Dimension	getDimension (Object key, Locale l) If the value of key for the given Locale is a Dimension return it, otherwise return null.
Font	getFont (Object key) If the value of key is a Font return it, otherwise return null.
Font	getFont (Object key, Locale l) If the value of key for the given Locale is a Font return it, otherwise return null.
Icon	getIcon (Object key) If the value of key is an Icon return it, otherwise return null.
Icon	getIcon (Object key, Locale l) If the value of key for the given Locale is an Icon return it, otherwise return null.
Insets	getInsets (Object key) If the value of key is an Insets return it, otherwise return null.
Insets	getInsets (Object key, Locale l) If the value of key for the given Locale is an Insets return it, otherwise return null.
int	getInt (Object key) If the value of key is an Integer return its integer value, otherwise return 0.
int	getInt (Object key, Locale l) If the value of key for the given Locale is an Integer return its integer value, otherwise return 0.
PropertyChangeListener []	getPropertyChangeListeners () Returns an array of all the PropertyChangeListeners added to this UIDefaults with addPropertyChangeListener().
String	getString (Object key) If the value of key is a String return it, otherwise return null.
String	getString (Object key, Locale l) If the value of key for the given Locale is a String return it, otherwise return null.
ComponentUI	getUI (JComponent target) Creates an ComponentUI implementation for the specified component.
Class <? extends ComponentUI >	getUIClass (String uiClassID) Returns the L&F class that renders this component.
Class <? extends ComponentUI >	getUIClass (String uiClassID, ClassLoader uiClassLoader) The value of get(uidClassID) must be the String name of a class that implements the corresponding ComponentUI class.
protected void	getUIError (String msg) If getUI() fails for any reason, it calls this method before returning null.
Object	put (Object key, Object value) Sets the value of key to value for all locales.
void	putDefaults (Object [] keyValueList) Puts all of the key/value pairs in the database and unconditionally generates one PropertyChangeEvent.
void	removePropertyChangeListener (PropertyChangeListener listener) Removes a PropertyChangeListener from the listener list.
void	removeResourceBundle (String bundleName) Removes a resource bundle from the list of resource bundles that are searched for localized defaults.
void	setDefaultLocale (Locale l) Sets the default locale.

Methods inherited from class java.util.Hashtable

clear , clone , contains , containsKey , containsValue , elements , entrySet , equals , hashCode , isEmpty , keys , keySet , putAll , rehash , remove , size , toString , values

Methods inherited from class java.lang.Object

finalize , getClass , notify , notifyAll , wait , wait , wait

Constructor Detail

UIDefaults

public UIDefaults()

Create an empty defaults table.

UIDefaults

public UIDefaults(Object   [] keyValueList)

Create a defaults table initialized with the specified key/value pairs. For example:

        Object[] uiDefaults = {
             "Font", new Font("Dialog", Font.BOLD, 12),
            "Color", Color.red,
             "five", new Integer(5)
        }
        UIDefaults myDefaults = new UIDefaults(uiDefaults);
 

Parameters:

keyValueList - an array of objects containing the key/value pairs

Method Detail

get

public Object    get(Object    key)

Returns the value for key. If the value is a UIDefaults.LazyValue then the real value is computed with LazyValue.createValue(), the table entry is replaced, and the real value is returned. If the value is an UIDefaults.ActiveValue the table entry is not replaced - the value is computed with ActiveValue.createValue() for each get() call. If the key is not found in the table then it is searched for in the list of resource bundles maintained by this object. The resource bundles are searched most recently added first using the locale returned by getDefaultLocale. LazyValues and ActiveValues are not supported in the resource bundles.

Specified by:

get in interface Map <Object ,Object >

Overrides:

get in class Hashtable <Object ,Object >

Parameters:

key - the desired key

Returns:

the value for key

Since:

1.4

See Also:

UIDefaults.LazyValue , UIDefaults.ActiveValue , Hashtable.get(java.lang.Object) , getDefaultLocale() , addResourceBundle(java.lang.String)

get

public Object    get(Object    key,
                  Locale    l)

Returns the value for key associated with the given locale. If the value is a UIDefaults.LazyValue then the real value is computed with LazyValue.createValue(), the table entry is replaced, and the real value is returned. If the value is an UIDefaults.ActiveValue the table entry is not replaced - the value is computed with ActiveValue.c