模块 java.desktop
包 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 设置/获取默认值。

Warning: 此类的序列化对象将与未来的 Swing 版本不兼容。当前的序列化支持适用于运行相同版本 Swing 的应用程序之间的短期存储或 RMI。从 1.4 开始，对所有 JavaBeans 的长期存储的支持已添加到 java.beans 包中。请参阅 XMLEncoder 。

自从：
1.2
参见：

  • 构造方法详细信息

    • UIDefaults

      public UIDefaults()
      创建一个空的默认表。

    • UIDefaults

      public UIDefaults(int initialCapacity, float loadFactor)
      创建具有指定初始容量和加载因子的空默认表。
      参数：
      initialCapacity - 默认表的初始容量
      loadFactor - 默认表的加载因子
      自从：
      1.6
      参见：

    • UIDefaults

      public UIDefaults(Object [] keyValueList)
      创建一个用指定的键/值对初始化的默认表。例如： 
          Object[] uiDefaults = {
       "Font", new Font("Dialog", Font.BOLD, 12),
      "Color", Color.red,
       "five", Integer.valueOf(5)
    }
    UIDefaults myDefaults = new UIDefaults(uiDefaults);
      参数：
      keyValueList - 包含键/值对的对象数组

  • 方法详情

    • get

      public Object  get(Object  key)
      返回键的值。如果该值为 UIDefaults.LazyValue，则使用 LazyValue.createValue() 计算实际值，替换表条目，并返回实际值。如果值为 UIDefaults.ActiveValue，则表条目不会被替换 - 对于每个 get() 调用，都会使用 ActiveValue.createValue() 计算该值。如果在表中找不到键，则在该对象维护的资源包列表中搜索它。首先使用 getDefaultLocale 返回的locale搜索最近添加的资源包。 LazyValues 和 ActiveValues 在资源包中不受支持。
      指定者：
      get 在接口 Map<Object,Object> 中
      重写：
      get 在类 Hashtable<Object,Object> 中
      参数：
      key - 所需的密钥
      返回：
      key 的值
      自从：
      1.4
      参见：

    • get

      public Object  get(Object  key, Locale  l)
      返回与给定locale关联的键的值。如果该值为 UIDefaults.LazyValue，则使用 LazyValue.createValue() 计算实际值，替换表条目，并返回实际值。如果值为 UIDefaults.ActiveValue，则表条目不会被替换 - 对于每个 get() 调用，都会使用 ActiveValue.createValue() 计算该值。如果在表中找不到键，则在该对象维护的资源包列表中搜索它。使用给定的locale首先搜索最近添加的资源包。 LazyValues 和 ActiveValues 在资源包中不受支持。
      参数：
      key - 所需的密钥
      l - 所需的 locale
      返回：
      key 的值
      自从：
      1.4
      参见：

    • put

      public Object  put(Object  key, Object  value)
      将所有locale的 key 的值设置为 value。如果 key 是一个字符串并且新值不等于旧值，则触发 PropertyChangeEvent 。如果值为 null ，则该键将从表中删除。
      指定者：
      put 在接口 Map<Object,Object> 中
      重写：
      put 在类 Hashtable<Object,Object> 中
      参数：
      key - 唯一的 Object who 值将用于检索与其关联的数据值
      value - 新的 Object 存储为该键下的数据
      返回：
      以前的 Object 值，或 null
      参见：

    • putDefaults

      public void putDefaults(Object [] keyValueList)
      将所有键/值对放入数据库并无条件生成一个 PropertyChangeEvent 。事件 oldValue 和 newValue 将为 null，其 propertyName 将为“UIDefaults”。为所有locale添加了键/值对。
      参数：
      keyValueList - 键/值对数组
      参见：

    • getFont

      public Font  getFont(Object  key)
      如果 key 的值是一个 Font 返回它，否则返回 null 。
      参数：
      key - 所需的密钥
      返回：
      如果 key 的值是 Font ，则返回 Font 对象；否则返回 null

    • getFont

      public Font  getFont(Object  key, Locale  l)
      如果给定 Locale 的 key 的值是一个 Font 返回它，否则返回 null 。
      参数：
      key - 所需的密钥
      l - 所需的locale
      返回：
      如果 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 - 所需的locale
      返回：
      如果 key 和 Locale 的值是 Color ，则返回 Color 对象；否则返回 null
      自从：
      1.4

    • getIcon

      public Icon  getIcon(Object  key)
      如果 key 的值是一个 Icon 返回它，否则返回 null 。
      参数：
      key - 所需的密钥
      返回：
      如果 key 的值是一个 Icon ，则返回 Icon 对象；否则返回 null

    • getIcon

      public Icon  getIcon(Object  key, Locale  l)
      如果给定 Locale 的 key 的值是一个 Icon 返回它，否则返回 null 。
      参数：
      key - 所需的密钥
      l - 所需的locale
      返回：
      如果 key 和 Locale 的值是一个 Icon ，则返回 Icon 对象；否则返回 null
      自从：
      1.4

    • getBorder

      public Border  getBorder(Object  key)
      如果 key 的值是一个 Border 返回它，否则返回 null 。
      参数：
      key - 所需的密钥
      返回：
      如果 key 的值是 Border ，则返回 Border 对象；否则返回 null

    • getBorder

      public Border  getBorder(Object  key, Locale  l)
      如果给定 Locale 的 key 的值是一个 Border 返回它，否则返回 null 。
      参数：
      key - 所需的密钥
      l - 所需的locale
      返回：
      如果 key 和 Locale 的值是 Border ，则返回 Border 对象；否则返回 null
      自从：
      1.4

    • getString

      public String  getString(Object  key)
      如果 key 的值是一个 String 返回它，否则返回 null 。
      参数：
      key - 所需的密钥
      返回：
      如果 key 的值是 String ，则返回 String 对象；否则返回 null

    • getString

      public String  getString(Object  key, Locale  l)
      如果给定 Locale 的 key 的值是一个 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 - 所需的locale
      返回：
      如果 key 和 Locale 的值是一个 Integer ，返回它的值，否则返回 0
      自从：
      1.4

    • getBoolean

      public boolean getBoolean(Object  key)
      如果key的值为boolean，则返回boolean值，否则返回false。
      参数：
      key - 一个 Object 为所需的boolean指定键
      返回：
      如果key的值为boolean，返回boolean，否则返回false。
      自从：
      1.4

    • getBoolean

      public boolean getBoolean(Object  key, Locale  l)
      如果给定 Locale 的 key 的值为boolean，则返回boolean，否则返回 false。
      参数：
      key - 一个 Object 为所需的boolean指定键
      l - 所需的locale
      返回：
      如果 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 返回它，否则返回 null 。
      参数：
      key - 所需的密钥
      l - 所需的locale
      返回：
      如果 key 和 Locale 的值是一个 Insets ，则返回 Insets 对象；否则返回 null
      自从：
      1.4

    • getDimension

      public Dimension  getDimension(Object  key)
      如果 key 的值是一个 Dimension 返回它，否则返回 null 。
      参数：
      key - 所需的密钥
      返回：
      如果 key 的值是 Dimension ，则返回 Dimension 对象；否则返回 null

    • getDimension

      public Dimension  getDimension(Object  key, Locale  l)
      如果给定 Locale 的 key 的值是一个 Dimension 返回它，否则返回 null 。
      参数：
      key - 所需的密钥
      l - 所需的locale
      返回：
      如果 key 和 Locale 的值是 Dimension ，则返回 Dimension 对象；否则返回 null
      自从：
      1.4

    • getUIClass

      public Class <? extends ComponentUI > getUIClass(String  uiClassID, ClassLoader  uiClassLoader)
      get(uidClassID) 的值必须是实现相应 ComponentUI 类的类的 String 名称。如果之前没有加载过该类，如果提供了非 null 类加载器，则此方法使用 uiClassLoader.loadClass() 查找该类，否则使用 classForName()。

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

      该方法由 getUI 使用，一般不需要直接调用。

      参数：
      uiClassID - 包含类 ID 的字符串
      uiClassLoader - 将加载类的对象
      返回：
      Class.forName(get(uidClassID)) 的值
      参见：

    • 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

      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
      参见：

    • removePropertyChangeListener

      public void removePropertyChangeListener(PropertyChangeListener  listener)
      从监听器列表中删除 PropertyChangeListener。这将删除为所有属性注册的 PropertyChangeListener。
      参数：
      listener - 要删除的 PropertyChangeListener
      参见：

    • getPropertyChangeListeners

      public PropertyChangeListener [] getPropertyChangeListeners()
      返回使用 addPropertyChangeListener() 添加到此 UIDefaults 的所有 PropertyChangeListener 的数组。
      返回：
      添加所有 PropertyChangeListener 或如果未添加任何监听器，则为空数组
      自从：
      1.4

    • firePropertyChange

      protected void firePropertyChange(String  propertyName, Object  oldValue, Object  newValue)
      支持报告绑定的属性更改。如果 oldValue 和 newValue 不相等并且 PropertyChangeEvent x 监听器列表不为空，则向每个监听器触发 PropertyChange 事件。
      参数：
      propertyName - 已更改属性的编程名称
      oldValue - 属性的旧值
      newValue - 属性的新值
      参见：

    • addResourceBundle

      public void addResourceBundle(String  bundleName)
      将资源包添加到搜索本地化值的资源包列表中。使用 系统类加载器 以相反的顺序搜索资源包。换句话说，首先搜索最近添加的包。
      参数：
      bundleName - 要添加的资源包的基本名称
      自从：
      1.4
      参见：

    • removeResourceBundle

      public void removeResourceBundle(String  bundleName)
      从搜索本地化默认值的资源包列表中删除资源包。
      参数：
      bundleName - 要删除的资源包的基本名称
      自从：
      1.4
      参见：

    • setDefaultLocale

      public void setDefaultLocale(Locale  l)
      设置默认locale。默认locale用于通过不采用locale参数的 get 方法检索本地化值。从 1.4 版开始，Swing UI 对象应该使用其组件的区域设置而不是默认区域设置来检索本地化值。默认locale的存在是为了提供与 1.4 之前的行为的兼容性。
      参数：
      l - 新的默认locale
      自从：
      1.4
      参见：

    • getDefaultLocale

      public Locale  getDefaultLocale()
      返回默认locale。默认locale用于通过不采用locale参数的 get 方法检索本地化值。从 1.4 版开始，Swing UI 对象应该使用其组件的区域设置而不是默认区域设置来检索本地化值。默认locale的存在是为了提供与 1.4 之前的行为的兼容性。
      返回：
      默认locale
      自从：
      1.4
      参见：