java.lang.Object java.util.Dictionary<K,V> java.util.Hashtable<Object,Object> javax.swing.UIDefaults
public class UIDefaults
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 JavaBeansTM has been added to the java.beans
package. Please see XMLEncoder
.
UIManager
static interface
UIDefaults.ActiveValue
getXXX(key)
methods. static class
UIDefaults.LazyInputMap
LazyInputMap
will create a InputMap
in its createValue
method. static interface
UIDefaults.LazyValue
getXXX(key)
methods. static class
UIDefaults.ProxyLazyValue
LazyValue
which can be used to delay loading of the Class for the instance to be created. Constructor Summary UIDefaults()
UIDefaults(Object[] keyValueList)
void
addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener
to the listener list. void
addResourceBundle(String bundleName)
protected void
firePropertyChange(String propertyName, Object oldValue, Object newValue)
Object
get(Object key)
Object
get(Object key, Locale l)
boolean
getBoolean(Object key)
key
is boolean, return the boolean value, otherwise return false. boolean
getBoolean(Object key, Locale l)
key
for the given Locale
is boolean, return the boolean value, otherwise return false. Border
getBorder(Object key)
key
is a Border
return it, otherwise return null
. Border
getBorder(Object key, Locale l)
key
for the given Locale
is a Border
return it, otherwise return null
. Color
getColor(Object key)
key
is a Color
return it, otherwise return null
. Color
getColor(Object key, Locale l)
key
for the given Locale
is a Color
return it, otherwise return null
. Locale
getDefaultLocale()
Dimension
getDimension(Object key)
key
is a Dimension
return it, otherwise return null
. Dimension
getDimension(Object key, Locale l)
key
for the given Locale
is a Dimension
return it, otherwise return null
. Font
getFont(Object key)
key
is a Font
return it, otherwise return null
. Font
getFont(Object key, Locale l)
key
for the given Locale
is a Font
return it, otherwise return null
. Icon
getIcon(Object key)
key
is an Icon
return it, otherwise return null
. Icon
getIcon(Object key, Locale l)
key
for the given Locale
is an Icon
return it, otherwise return null
. Insets
getInsets(Object key)
key
is an Insets
return it, otherwise return null
. Insets
getInsets(Object key, Locale l)
key
for the given Locale
is an Insets
return it, otherwise return null
. int
getInt(Object key)
key
is an Integer
return its integer value, otherwise return 0. int
getInt(Object key, Locale l)
key
for the given Locale
is an Integer
return its integer value, otherwise return 0. PropertyChangeListener[]
getPropertyChangeListeners()
PropertyChangeListener
s added to this UIDefaults with addPropertyChangeListener(). String
getString(Object key)
key
is a String
return it, otherwise return null
. String
getString(Object key, Locale l)
key
for the given Locale
is a String
return it, otherwise return null
. ComponentUI
getUI(JComponent target)
ComponentUI
implementation for the specified component. Class<? extends ComponentUI>
getUIClass(String uiClassID)
Class<? extends ComponentUI>
getUIClass(String uiClassID, ClassLoader uiClassLoader)
get(uidClassID)
must be the String
name of a class that implements the corresponding ComponentUI
class. protected void
getUIError(String msg)
getUI()
fails for any reason, it calls this method before returning null
. Object
put(Object key, Object value)
key
to value
for all locales. void
putDefaults(Object[] keyValueList)
PropertyChangeEvent
. void
removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener
from the listener list. void
removeResourceBundle(String bundleName)
void
setDefaultLocale(Locale l)
clear, clone, contains, containsKey, containsValue, elements, entrySet, equals, hashCode, isEmpty, keys, keySet, putAll, rehash, remove, size, toString, values
UIDefaults
public UIDefaults()
public UIDefaults(Object[] keyValueList)
Object[] uiDefaults = { "Font", new Font("Dialog", Font.BOLD, 12), "Color", Color.red, "five", new Integer(5) } UIDefaults myDefaults = new UIDefaults(uiDefaults);
keyValueList
- an array of objects containing the key/value pairs
public Object get(Object key)
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.
get
in interface Map<Object,Object>
get
in class Hashtable<Object,Object>
key
- the desired key
key
UIDefaults.LazyValue
, UIDefaults.ActiveValue
, Hashtable.get(java.lang.Object)
, getDefaultLocale()
, addResourceBundle(java.lang.String)
public Object get(Object key, Locale l)
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 given locale. LazyValues
and ActiveValues
are not supported in the resource bundles.
key
- the desired key
l
- the desired locale
key
UIDefaults.LazyValue
, UIDefaults.ActiveValue
, Hashtable.get(java.lang.Object)
, addResourceBundle(java.lang.String)
public Object put(Object key, Object value)
key
to value
for all locales. 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.
put
in interface Map<Object,Object>
put
in class Hashtable<Object,Object>
key
- the unique Object
who's value will be used to retrieve the data value associated with it
value
- the new Object
to store as data under that key
Object
value, or null
putDefaults(java.lang.Object[])
, Hashtable.put(K, V)
public void putDefaults(Object[] keyValueList)
PropertyChangeEvent
. The events oldValue and newValue will be null
and its propertyName
will be "UIDefaults". The key/value pairs are added for all locales.
keyValueList
- an array of key/value pairs
put(java.lang.Object, java.lang.Object)
, Hashtable.put(K, V)
public Font getFont(Object key)
key
is a Font
return it, otherwise return null
.
key
- the desired key
key
is a Font
, return the Font
object; otherwise return null
public Font getFont(Object key, Locale l)
key
for the given Locale
is a Font
return it, otherwise return null
.
key
- the desired key
l
- the desired locale
key
and Locale
is a Font
, return the Font
object; otherwise return null
public Color getColor(Object key)
key
is a Color
return it, otherwise return null
.
key
- the desired key
key
is a Color
, return the Color
object; otherwise return null
public Color getColor(Object key, Locale l)
key
for the given Locale
is a Color
return it, otherwise return null
.
key
- the desired key
l
- the desired locale
key
and Locale
is a Color
, return the Color
object; otherwise return null
public Icon getIcon(Object key)
key
is an Icon
return it, otherwise return null
.
key
- the desired key
key
is an Icon
, return the Icon
object; otherwise return null
public Icon getIcon(Object key, Locale l)
key
for the given Locale
is an Icon
return it, otherwise return null
.
key
- the desired key
l
- the desired locale
key
and Locale
is an Icon
, return the Icon
object; otherwise return null
public Border getBorder(Object key)
key
is a Border
return it, otherwise return null
.
key
- the desired key
key
is a Border
, return the Border
object; otherwise return null
public Border getBorder(Object key, Locale l)
key
for the given Locale
is a Border
return it, otherwise return null
.
key
- the desired key
l
- the desired locale
key
and Locale
is a Border
, return the Border
object; otherwise return null
public String getString(Object key)
key
is a String
return it, otherwise return null
.
key
- the desired key
key
is a String
, return the String
object; otherwise return null
public String getString(Object key, Locale l)
key
for the given Locale
is a String
return it, otherwise return null
.
key
- the desired key
l
- the desired Locale
key
for the given Locale
is a String
, return the String
object; otherwise return null
public int getInt(Object key)
key
is an Integer
return its integer value, otherwise return 0.
key
- the desired key
key
is an Integer
, return its value, otherwise return 0
public int getInt(Object key, Locale l)
key
for the given Locale
is an Integer
return its integer value, otherwise return 0.
key
- the desired key
l
- the desired locale
key
and Locale
is an Integer
, return its value, otherwise return 0
public boolean getBoolean(Object key)
key
is boolean, return the boolean value, otherwise return false.
key
- an Object
specifying the key for the desired boolean value
key
is boolean, return the boolean value, otherwise return false.
public boolean getBoolean(Object key, Locale l)
key
for the given Locale
is boolean, return the boolean value, otherwise return false.
key
- an Object
specifying the key for the desired boolean value
l
- the desired locale
key
and Locale
is boolean, return the boolean value, otherwise return false.
public Insets getInsets(Object key)
key
is an Insets
return it, otherwise return null
.
key
- the desired key
key
is an Insets
, return the Insets
object; otherwise return null
public Insets getInsets(Object key, Locale l)
key
for the given Locale
is an Insets
return it, otherwise return null
.
key
- the desired key
l
- the desired locale
key
and Locale
is an Insets
, return the Insets
object; otherwise return null
public Dimension getDimension(Object key)
key
is a Dimension
return it, otherwise return null
.
key
- the desired key
key
is a Dimension
, return the Dimension
object; otherwise return null
public Dimension getDimension(Object key, Locale l)
key
for the given Locale
is a Dimension
return it, otherwise return null
.
key
- the desired key
l
- the desired locale
key
and Locale
is a Dimension
, return the Dimension
object; otherwise return null
public Class<? extends ComponentUI> getUIClass(String uiClassID, ClassLoader uiClassLoader)
get(uidClassID)
must be the String
name of a class that implements the corresponding ComponentUI
class. If the class hasn't been loaded before, this method looks up the class with uiClassLoader.loadClass()
if a non null
class loader is provided, classForName()
otherwise.
If a 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 necessary to call it directly.
uiClassID
- a string containing the class ID
uiClassLoader
- the object which will load the class
Class.forName(get(uidClassID))
getUI(javax.swing.JComponent)
public Class<? extends ComponentUI> getUIClass(String uiClassID)
uiClassID
- a string containing the class ID
getUIClass(uiClassID, null)
protected void getUIError(String msg)
getUI()
fails for any reason, it calls this method before returning null
. Subclasses may choose to do more or less here.
msg
- message string to print
getUI(javax.swing.JComponent)
public ComponentUI getUI(JComponent target)
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:
ComponentUI
implementation class under the value returned by target.getUIClassID()
.createUI()
method to construct a look and feel delegate.target
- the JComponent
which needs a UI
ComponentUI
object
public void addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener
to the listener list. The listener is registered for all properties.
A PropertyChangeEvent
will get fired whenever a default is changed.
listener
- the PropertyChangeListener
to be added
PropertyChangeSupport
public void removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener
from the listener list. This removes a PropertyChangeListener
that was registered for all properties.
listener
- the PropertyChangeListener
to be removed
PropertyChangeSupport
public PropertyChangeListener[] getPropertyChangeListeners()
PropertyChangeListener
s added to this UIDefaults with addPropertyChangeListener().
PropertyChangeListener
s added or an empty array if no listeners have been added
protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
PropertyChangeEvent
x listener list isn't empty, then fire a PropertyChange
event to each listener.
propertyName
- the programmatic name of the property that was changed
oldValue
- the old value of the property
newValue
- the new value of the property
PropertyChangeSupport
public void addResourceBundle(String bundleName)
bundleName
- the base name of the resource bundle to be added
ResourceBundle
, removeResourceBundle(java.lang.String)
public void removeResourceBundle(String bundleName)
bundleName
- the base name of the resource bundle to be removed
ResourceBundle
, addResourceBundle(java.lang.String)
public void setDefaultLocale(Locale l)
get
methods that do not take a locale argument. As of release 1.4, Swing UI objects should retrieve localized values using the locale of their component rather than the default locale. The default locale exists to provide compatibility with pre 1.4 behaviour.
l
- the new default locale
getDefaultLocale()
, get(Object)
, get(Object,Locale)
public Locale getDefaultLocale()
get
methods that do not take a locale argument. As of release 1.4, Swing UI objects should retrieve localized values using the locale of their component rather than the default locale. The default locale exists to provide compatibility with pre 1.4 behaviour.
setDefaultLocale(java.util.Locale)
, get(Object)
, get(Object,Locale)
Copyright © 2004, 2010 Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4