Overview | Package | Class | Tree | Deprecated | Index | Help			Java Platform 1.1.7
PREV CLASS | NEXT CLASS	FRAMES | NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

Class com.sun.java.swing.UIDefaults

java.lang.Object
  |
  +--java.util.Dictionary
        |
        +--java.util.Hashtable
              |
              +--com.sun.java.swing.UIDefaults

public class UIDefaults

extends java.util.Hashtable

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 Swing1.0 applications. It will not be possible to load serialized Swing1.0 objects with future releases of Swing. The JDK1.2 release of Swing will be the compatibility baseline for the serialized form of Swing objects.

See Also:

UIManager, Serialized Form

Inner Class Summary

static	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	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.

Constructor Summary

UIDefaults()
Create an empty defaults table.

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

Method Summary

void	addPropertyChangeListener(java.beans.PropertyChangeListener listener) Add a PropertyChangeListener to the listener list.
void	firePropertyChange(java.lang.String propertyName, java.lang.Object oldValue, java.lang.Object newValue) Support for reporting bound property changes.
Border	getBorder(java.lang.Object key) If the value of key is a Border return it, otherwise return null.
java.awt.Color	getColor(java.lang.Object key) If the value of key is a Color return it, otherwise return null.
java.awt.Font	getFont(java.lang.Object key) If the value of key is a Font return it, otherwise return null.
Icon	getIcon(java.lang.Object key) If the value of key is an Icon return it, otherwise return null.
java.lang.String	getString(java.lang.Object key) If the value of key is a String return it, otherwise return null.
java.lang.Class	getUIClass(java.lang.String uiClassID) The value of get(uidClassID) must be the String name of a class that implements the corresponding ComponentUI class.
java.lang.Object	get(java.lang.Object key)
void	getUIError(java.lang.String msg) If getUI() fails for any reason, it calls this method before returning null.
com.sun.java.swing.plaf.ComponentUI	getUI(JComponent target) Create an ComponentUI implementation for the specified component.
void	putDefaults(java.lang.Object[] keyValueList) Put all of the key/value pairs in the database and unconditionally generate one PropertyChangeEvent.
java.lang.Object	put(java.lang.Object key, java.lang.Object value) Set the value of key to value.
void	removePropertyChangeListener(java.beans.PropertyChangeListener listener) Remove a PropertyChangeListener from the listener list.

Methods inherited from class java.util.Hashtable

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

Methods inherited from class java.util.Dictionary

elements, get, isEmpty, keys, put, remove, size

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notifyAll, notify, toString, wait, wait, wait

Constructor Detail

UIDefaults

public UIDefaults()

Create an empty defaults table.

UIDefaults

public UIDefaults(java.lang.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);
 

Method Detail

get

public java.lang.Object get(java.lang.Object key)

Overrides:

get in class java.util.Hashtable

put

public java.lang.Object put(java.lang.Object key,
                  java.lang.Object value)

Set the value of key to value. If key is a string and the new value isn't equal to the old one, fire a PropertyChangeEvent. If value is null, the key is removed from the table.

Overrides:

put in class java.util.Hashtable

See Also:

putDefaults, put

putDefaults

public void putDefaults(java.lang.Object[] keyValueList)

Put all of the key/value pairs in the database and unconditionally generate one PropertyChangeEvent. The events oldValue and newValue will be null and its propertyName will be "UIDefaults".

See Also:

put, put

getFont

public java.awt.Font getFont(java.lang.Object key)

If the value of key is a Font return it, otherwise return null.

getColor

public java.awt.Color getColor(java.lang.Object key)

If the value of key is a Color return it, otherwise return null.

getIcon

public Icon getIcon(java.lang.Object key)

If the value of key is an Icon return it, otherwise return null.

getBorder

public Border getBorder(java.lang.Object key)

If the value of key is a Border return it, otherwise return null.

getString

public java.lang.String getString(java.lang.Object key)

If the value of key is a String return it, otherwise return null.

getUIClass

public java.lang.Class getUIClass(java.lang.String uiClassID)

The value of get(uidClassID) must be the String name of a class that implements the corresponding ComponentUI class. This method looks up the class with classForName() and returns it. If no mapping for uiClassID exists or if the specified class can't be found, return null.

This method is used by getUI, it's usually not neccessary to call it directly.

Returns:

The value of Class.forName(get(uidClassID)).

See Also:

getUI

getUIError

protected void getUIError(java.lang.String msg)

If getUI() fails for any reason, it calls this method before returning null. Subclasses may choose to do more or less here.

Parameters:

msg - Message string to print.

See Also:

getUI

getUI

public com.sun.java.swing.plaf.ComponentUI getUI(JComponent target)

Create an ComponentUI implementation for the specified component. In other words create the look and feel specific delegate object for target. This is done in two steps:

• Lookup the name of the ComponentUI implementation class under the value returned by target.getUIClassID().
• Use the implementation classes static createUI() method to construct a look and feel delegate.

addPropertyChangeListener

public void addPropertyChangeListener(java.beans.PropertyChangeListener listener)

Add a PropertyChangeListener to the listener list. The listener is registered for all properties.

A PropertyChangeEvent will get fired whenever a default is changed.

Parameters:

listener - The PropertyChangeListener to be added

See Also:

java.beans.PropertyChangeSupport

removePropertyChangeListener

public void removePropertyChangeListener(java.beans.PropertyChangeListener listener)

Remove a PropertyChangeListener from the listener list. This removes a PropertyChangeListener that was registered for all properties.

Parameters:

listener - The PropertyChangeListener to be removed

See Also:

java.beans.PropertyChangeSupport

firePropertyChange

protected void firePropertyChange(java.lang.String propertyName,
                                  java.lang.Object oldValue,
                                  java.lang.Object newValue)

Support for reporting bound property changes. If oldValue and newValue are not equal and the PropertyChangeEvent listener list isn't empty, then fire a PropertyChange event to each listener.

Parameters:

propertyName - The programmatic name of the property that was changed.

oldValue - The old value of the property.

newValue - The new value of the property.

See Also:

java.beans.PropertyChangeSupport