模块  java.desktop
软件包  javax.swing

Class UIDefaults

  • 实现的所有接口
    Serializable ， Cloneable ， Map<Object,​Object> 
    public class UIDefaults
extends Hashtable<Object,​Object>
    Swing组件的默认表。 应用程序可以通过UIManager设置/获取默认值。

    警告：此类的序列化对象与以后的Swing版本不兼容。 当前的序列化支持适用于运行相同版本Swing的应用程序之间的短期存储或RMI。 从1.4开始， java.beans软件包中添加了对所有JavaBeans java.beans长期存储的支持。 请参阅XMLEncoder 。

    从以下版本开始：
    1.2
    另请参见：
    UIManager ， Serialized Form

    • 构造方法详细信息

      • 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", Integer.valueOf(5)
        }
        UIDefaults myDefaults = new UIDefaults(uiDefaults);
        参数
        keyValueList - 包含键/值对的对象数组

    • 方法详细信息

      • 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)
        为所有语言环境设置value的值为key 。 如果key是一个字符串且新值不等于旧值，则触发PropertyChangeEvent 。 如果值为null ，则从表中删除密钥。
        Specified by:
        put在界面 Map<Object,​Object>
        重写：
        put在类 Hashtable<Object,​Object>
        参数
        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返回它，否则返回 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)
        如果值 key对于给定的 Locale是 Color返回它，否则返回 null 。
        参数
        key - 所需的密钥
        l - 所需的区域设置
        结果
        如果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)
        如果值 key对于给定的 Locale是 Icon返回它，否则返回 null 。
        参数
        key - 所需的密钥
        l - 所需的区域设置
        结果
        如果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)
        如果值 key对于给定的 Locale是 Border返回它，否则返回 null 。
        参数
        key - 所需的密钥
        l - 所需的区域设置
        结果
        如果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)
        如果值 key对于给定的 Locale是 String返回它，否则返回 null 。
        参数
        key - 所需的密钥
        l - 所需的 Locale
        结果
        如果该值key对于给定Locale为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)
        如果值 key对于给定 Locale为 Integer返回其整数值，否则返回0。
        参数
        key - 所需的密钥
        l - 所需的区域设置
        结果
        如果 key和 Locale的值是 Integer ，则返回其值，否则返回0
        从以下版本开始：
        1.4

      • getBoolean

        public boolean getBoolean​(Object key)
        如果 key值为boolean，则返回布尔值，否则返回false。
        参数
        key - 指定所需布尔值的键的 Object
        结果
        如果 key值为boolean，则返回布尔值，否则返回false。
        从以下版本开始：
        1.4

      • getBoolean

        public boolean getBoolean​(Object key,
                          Locale l)
        如果给定 Locale的值为 key为boolean，则返回布尔值，否则返回false。
        参数
        key - Object指定所需布尔值的键
        l - 所需的区域设置
        结果
        如果 key和 Locale值为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)
        如果值 key对于给定的 Locale是 Insets返回它，否则返回 null 。
        参数
        key - 所需的密钥
        l - 所需的区域设置
        结果
        如果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)
        如果值 key对于给定的 Locale是 Dimension返回它，否则返回 null 。
        参数
        key - 所需的密钥
        l - 所需的区域设置
        结果
        如果key和Locale的值是Dimension ，则返回Dimension对象; 否则返回null
        从以下版本开始：
        1.4

      • getUIClass

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

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

        该方法由getUI ，通常不需要直接调用它。

        参数
        uiClassID - 包含类ID的字符串
        uiClassLoader - 将加载类的对象
        结果
        值 Class.forName(get(uidClassID))
        另请参见：
        getUI(javax.swing.JComponent)

      • getUIClass

        public 类<? extends ComponentUI> getUIClass​(String uiClassID)
        返回呈现此组件的L＆F类。
        参数
        uiClassID - 包含类ID的字符串
        结果
        getUIClass(uiClassID, null)返回的Class对象

      • getUIError

        protected void getUIError​(String msg)
        如果getUI()因任何原因失败，则在返回null之前调用此方法。 子类可以选择在这里做更多或更少。
        参数
        msg - 要打印的消息字符串
        另请参见：
        getUI(javax.swing.JComponent)

      • getUI

        public ComponentUI getUI​(JComponent target)
        为指定的组件创建ComponentUI实现。 换句话说，为target创建外观特定的委托对象。 这分两步完成：
        • 中查找的名称ComponentUI实现类返回的值下target.getUIClassID() 。
        • 使用实现类static 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 s或空数组
        从以下版本开始：
        1.4

      • firePropertyChange

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

      • removeResourceBundle

        public void removeResourceBundle​(String bundleName)
        从搜索本地化默认值的资源包列表中删除资源包。
        参数
        bundleName - 要删除的资源包的基本名称
        从以下版本开始：
        1.4
        另请参见：
        ResourceBundle ， addResourceBundle(java.lang.String)

      • setDefaultLocale

        public void setDefaultLocale​(Locale l)
        设置默认语言环境。 默认语言环境用于通过不采用语言环境参数的get方法检索本地化值。 从1.4版开始，Swing UI对象应该使用其组件的语言环境而不是默认语言环境来检索本地化值。 存在默认语言环境以提供与1.4之前的行为的兼容性。
        参数
        l - 新的默认语言环境
        从以下版本开始：
        1.4
        另请参见：
        getDefaultLocale() ， get(Object) ， get(Object,Locale)

      • getDefaultLocale

        public Locale getDefaultLocale()
        返回默认语言环境。 默认语言环境用于通过不采用语言环境参数的get方法检索本地化值。 从1.4版开始，Swing UI对象应该使用其组件的语言环境而不是默认语言环境来检索本地化值。 存在默认语言环境以提供与1.4之前的行为的兼容性。
        结果
        默认语言环境
        从以下版本开始：
        1.4
        另请参见：
        setDefaultLocale(java.util.Locale), get(Object), get(Object,Locale)