javax.swing
类 UIDefaults

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

所有已实现的接口：

Serializable, Cloneable, Map<Object,Object>

public class UIDefaults
extends Hashtable<Object,Object>

Swing 组件的默认值表。应用程序可以通过 UIManager 设置/获取默认值。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

另请参见：

UIManager

UIDefaults

public UIDefaults()

创建一个空默认值表。

UIDefaults

public UIDefaults(int initialCapacity,
                  float loadFactor)

创建一个带有指定初始容量和加载因子的空默认值表。

参数：

initialCapacity - 默认值表的初始容量

loadFactor - 默认值表的加载因子

从以下版本开始：

1.6

另请参见：

Hashtable

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 - 包含键/值对的对象数组

get

public Object get(Object key)

返回键的值。如果该值为 UIDefaults.LazyValue，则使用 LazyValue.createValue() 计算其实际值，替换表项并返回实际值。如果该值为 UIDefaults.ActiveValue，则不替换表项，而是使用每个 get() 调用的 ActiveValue.createValue() 来计算该值。如果未在表中找到该键，则在此对象维护的资源包中搜索它。使用由 getDefaultLocale 返回的语言环境首先搜索最近添加的资源包。LazyValues 和 ActiveValues 在资源包中不受支持。

指定者：

接口 Map<Object,Object> 中的 get

覆盖：

类 Hashtable<Object,Object> 中的 get

参数：

key - 所需的键

返回：

key 的值

从以下版本开始：

1.4

另请参见：

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

get

public Object get(Object key,
                  Locale l)

返回与给定语言环境相关的那些键的值。如果该值为 UIDefaults.LazyValue，则使用 LazyValue.createValue() 计算其实际值、替换表项并返回实际值。如果该值为 UIDefaults.ActiveValue，则不替换表项，而是使用每个 get() 调用的 ActiveValue.createValue() 来计算该值。如果未在表中找到该键，则在由此对象维护的资源包中搜索它。使用给定的语言环境首先搜索最近添加的资源包。LazyValues 和 ActiveValues 在资源包中不受支持。

参数：

key - 所需的键

l - 所需的 locale

返回：

key 的值

从以下版本开始：

1.4

另请参见：

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

put

public Object put(Object key,
                  Object value)

将 key 值设置为所有语言环境的 value。如果 key 为一个字符串且新值不等于旧值，则触发一个 PropertyChangeEvent。如果值为 null，则从表中移除该键。

指定者：

接口 Map<Object,Object> 中的 put

覆盖：

类 Hashtable<Object,Object> 中的 put

参数：

key - 使用其值检索与之相关的数据值的惟一 Object

value - 要以数据形式在该键下存储的新 Object

返回：

以前的 Object 值，或 null

另请参见：

putDefaults(java.lang.Object[]), Hashtable.put(K, V)

putDefaults

public void putDefaults(Object[] keyValueList)

将所有键/值对放入数据库中，并无条件地生成一个 PropertyChangeEvent。事件 oldValue 和 newValue 将为 null，而其 propertyName 将为“UIDefaults”。为所有语言环境添加键/值对。

参数：

keyValueList - 键/值对数组

另请参见：

put(java.lang.Object, java.lang.Object), Hashtable.put(K, V)

getFont

public Font getFont(Object key)

如果 key 值为一个 Font，则返回该 Font，否则返回 null。

参数：

key - 所需的键

返回：

如果 key 的值为一个 Font，则返回该 Font 对象；否则返回 null

getFont

public Font getFont(Object key,
                    Locale l)

如果给定 Locale 的 key 值为一个 Font，则返回它，否则返回 null。

参数：

key - 所需的键

l - 所需语言环境

返回：

如果 key 和 Locale 的值为一个 Font，则返回该 Font 对象；否则返回 null

从以下版本开始：

1.4

getColor

public Color getColor(Object key)

如果 key 值为一个 Color，则返回它，否则返回 null。

参数：

key - 所需的键

返回：

如果 key 的值为一个 Color，则返回该 Color 对象；否则返回 null

getColor

public Color getColor(Object key,
                      Locale l)

如果给定 Locale 的 key 值为一个 Color，则返回它，否则返回 null。

参数：

key - 所需的键

l - 所需的语言环境

返回：

如果 key 和 Locale 的值为一个 Color，则返回该 Color 对象；否则返回 null

从以下版本开始：

1.4

getIcon

public Icon getIcon(Object key)

如果 key 值为一个 Icon，则返回该 Icon，否则返回 null。

参数：

key - 所需的键

返回：

如果 key 的值为一个 Icon，则返回该 Icon 对象；否则返回 null

getIcon

public Icon getIcon(Object key,
                    Locale l)

如果给定 Locale 的 key 值为一个 Icon，则返回该 Icon，否则返回 null。

参数：

key - 所需的键

l - 所需的语言环境

返回：

如果 key 和 Locale 的值为一个 Icon，则返回该 Icon 对象；否则返回 null

从以下版本开始：

1.4

getBorder

public Border getBorder(Object key)

如果 key 值为一个 Border，则返回该 Border，否则返回 null。

参数：

key - 所需的键

返回：

如果 key 的值为一个 Border，则返回该 Border 对象；否则返回 null

getBorder

public Border getBorder(Object key,
                        Locale l)

如果给定 Locale 的 key 值为一个 Border，则返回该 Border，否则返回 null。

参数：

key - 所需的键

l - 所需的语言环境

返回：

如果 key 和 Locale 的值为一个 Border，则返回该 Border 对象；否则返回 null

从以下版本开始：

1.4

getString

public String getString(Object key)

如果 key 值为一个 String，则返回该 String，否则返回 null。

参数：

key - 所需的键

返回：

如果 key 的值为一个 String，则返回该 String 对象；否则返回 null

getString

public String getString(Object key,
                        Locale l)

如果给定 Locale 的 key 值为一个 String，则返回该 String，否则返回 null。

参数：

key - 所需的键

l - 所需的 Locale

返回：

如果给定 Locale 的 key 的值为一个 String，则返回该 String 对象；否则返回 null

从以下版本开始：

1.4

getInt

public int getInt(Object key)

如果 key 值为一个 Integer，则返回该整数值，否则返回 0。

参数：

key - 所需的键

返回：

如果 key 的值为一个 Integer，则返回其值，否则返回 0

getInt

public int getInt(Object key,
                  Locale l)

如果给定 Locale 的 key 值为一个 Integer，则返回其整数值，否则返回 0。

参数：

key - 所需的键

l - 所需的语言环境

返回：

如果 key 和 Locale 的值为一个 Integer，则返回其值，否则返回 0

从以下版本开始：

1.4

getBoolean

public boolean getBoolean(Object key)

如果 key 是 boolean 值，则返回该 boolean 值，否则返回 false。

参数：

key - 指定所需 boolean 值的键的 Object

返回：

如果 key 值是 boolean 值，则返回该 boolean 值，否则返回 false。

从以下版本开始：

1.4

getBoolean

public boolean getBoolean(Object key,
                          Locale l)

如果给定 Locale 的 key 值是 boolean 值，则返回该 boolean 值，否则返回 false。

参数：

key - 一个指定所需 boolean 值的键的 Object

l - 所需的语言环境

返回：

如果 key 和 Locale 的值是 boolean 值，则返回该 boolean 值，否则返回 false。

从以下版本开始：

1.4

getInsets

public Insets getInsets(Object key)

如果 key 值为一个 Insets，则返回它，否则返回 null。

参数：

key - 所需的键

返回：

如果 key 的值为一个 Insets，则返回该 Insets 对象；否则返回 null

getInsets

public Insets getInsets(Object key,
                        Locale l)

如果给定 Locale 的 key 值为一个 Insets，则返回该 Insets，否则返回 null。

参数：

key - 所需的键

l - 所需的语言环境

返回：

如果 key 和 Locale 的值为一个 Insets，则返回该 Insets 对象；否则返回 null

从以下版本开始：

1.4

getDimension

public Dimension getDimension(Object key)

如果 key 值为一个 Dimension，则返回该 Dimension，否则返回 null。

参数：

key - 所需的键

返回：

如果 key 的值为一个 Dimension，则返回该 Dimension 对象；否则返回 null

getDimension

public Dimension getDimension(Object key,
                              Locale l)

如果给定 Locale 的 key 值为一个 Dimension，则返回该 Dimension，否则返回 null。

参数：

key - 所需的键

l - 所需的语言环境

返回：

如果 key 和 Locale 的值为一个 Dimension，则返回该 Dimension 对象；否则返回 null

从以下版本开始：

1.4

getUIClass

public Class<? extends ComponentUI> getUIClass(String uiClassID,
                                               ClassLoader uiClassLoader)

get(uidClassID) 的值必须为一个类的 String 名称，该类实现相应的 ComponentUI 类。如果以前未加载该类，若提供非 null 类加载器，则此方法会使用 uiClassLoader.loadClass() 查找该类，否则使用 classForName() 查找。

如果 uiClassID 的映射关系存在，或者无法找到指定类，则返回 null。

此方法由 getUI 使用，通常不必直接调用该方法。

参数：

uiClassID - 一个包含类 ID 的字符串

uiClassLoader - 将加载该类的对象

返回：

Class.forName(get(uidClassID)) 的值

另请参见：

getUI(javax.swing.JComponent)

getUIClass

public Class<? extends ComponentUI> getUIClass(String uiClassID)

返回呈现此组件的 L&F 类。

参数：

uiClassID - 一个包含类 ID 的字符串

返回：

由 getUIClass(uiClassID, null) 返回的类对象

getUIError

protected void getUIError(String msg)

如果由于某种原因导致 getUI() 失败，则它会在返回 null 之前调用此方法。子类在这里也可以选择执行差不多的操作。

参数：

msg - 要打印的消息字符串

另请参见：

getUI(javax.swing.JComponent)

getUI

public ComponentUI getUI(JComponent target)

创建一个指定组件的 ComponentUI 实现。换句话说，创建 target 的特定于外观的委托对象。此操作分以下两步进行：

• 查找由 target.getUIClassID() 返回的值下的 ComponentUI 实现类的名称。
• 使用该实现类的静态 createUI() 方法构造一个外观代理。

参数：

target - 需要 UI 的 JComponent

返回：

该 ComponentUI 对象

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

向侦听器列表添加一个 PropertyChangeListener。该侦听器是为所有属性注册的。

每更改一个默认值时，都将触发一个 PropertyChangeEvent。

参数：

listener - 要添加的 PropertyChangeListener

另请参见：

PropertyChangeSupport

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

从侦听器列表移除一个 PropertyChangeListener。此方法移除了一个为所有属性注册的 PropertyChangeListener。

参数：

listener - 要移除的 PropertyChangeListener

另请参见：

PropertyChangeSupport

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

返回使用 addPropertyChangeListener() 添加到此 UIDefaults 的所有 PropertyChangeListener 组成的数组。

返回：

添加的所有 PropertyChangeListener，如果没有添加侦听器，则返回一个空数组

从以下版本开始：

1.4

firePropertyChange

protected void firePropertyChange(String propertyName,
                                  Object oldValue,
                                  Object newValue)

支持报告绑定属性更改。如果 oldValue 和 newValue 不相等，且 PropertyChangeEventx 侦听器列表不为空，则对每个侦听器触发一个 PropertyChange。

参数：

propertyName - 已更改的属性的编程名称

oldValue - 属性的旧值

newValue - 属性的新值

另请参见：

PropertyChangeSupport

addResourceBundle

public void addResourceBundle(String bundleName)

将一个资源包添加到从中搜索本地化值的资源包的列表中。按添加时的反向顺序搜索资源包。换句话说，就是搜索最近刚添加的包。

参数：

bundleName - 要添加的资源包的基本名称

从以下版本开始：

1.4

另请参见：

ResourceBundle, removeResourceBundle(java.lang.String)

removeResourceBundle

public void removeResourceBundle(String bundleName)

从在其中搜索本地化默认的资源包列表中移除一个资源包。

参数：

bundleName - 要移除的资源包的基本名称

从以下版本开始：

1.4

另请参见：

ResourceBundle, addResourceBundle(java.lang.String)

setDefaultLocale

public void setDefaultLocale(Locale l)

设置默认语言环境。通过不带 locale 参数的 get 方法，使用默认语言环境检索本地化值。从版本 1.4 开始，Swing UI 对象应该使用其组件的语言环境而不是使用默认语言环境检索本地化值。默认的语言环境可以与 1.4 以前的行为兼容。

参数：

l - 新的默认语言环境

从以下版本开始：

1.4

另请参见：

getDefaultLocale(), get(Object), get(Object,Locale)

getDefaultLocale

public Locale getDefaultLocale()

返回该默认语言环境。通过不带 locale 参数的 get 方法，使用默认语言环境检索本地化值。从版本 1.4 开始，Swing UI 对象应该使用其组件的语言环境而不是使用默认语言环境检索本地化值。默认的语言环境可以与 1.4 以前的行为兼容。

返回：

该默认语言环境

从以下版本开始：

1.4

另请参见：

setDefaultLocale(java.util.Locale), get(Object), get(Object,Locale)

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。