©
本文档使用 PHP中文网手册 发布
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.util.Dictionary<K,V> java.util.Hashtable<Object,Object> javax.swing.UIDefaults
public class UIDefaults
Swing 组件的默认值表。应用程序可以通过 UIManager
设置/获取默认值。
警告:此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储,或适用于在运行相同 Swing 版本的应用程序之间进行 RMI(Remote Method Invocation,远程方法调用)。从 1.4 版本开始,已在 java.beans
包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder
。
UIManager
嵌套类摘要 | |
---|---|
static interface |
UIDefaults.ActiveValue
此类使用户能够在默认表中存储项,该默认表在每次使用某个 getXXX(key) 方法进行查找时创建。 |
static class |
UIDefaults.LazyInputMap
LazyInputMap 将在其 createValue 方法中创建一个 InputMap 。 |
static interface |
UIDefaults.LazyValue
此类使用户能够在默认表中存储项,该默认表只有在第一次使用某个 getXXX(key) 方法进行查找时才创建。 |
static class |
UIDefaults.ProxyLazyValue
此类提供一个可用于延迟加载要创建实例类的 LazyValue 的实现。 |
构造方法摘要 | |
---|---|
UIDefaults()
创建一个空默认值表。 |
|
UIDefaults(int initialCapacity,
float loadFactor)
创建一个带有指定初始容量和加载因子的空默认值表。 |
|
UIDefaults(Object[] keyValueList)
创建一个使用指定键/值对初始化的默认值表。 |
方法摘要 | |
---|---|
void |
addPropertyChangeListener(PropertyChangeListener listener)
向侦听器列表添加一个 PropertyChangeListener 。 |
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 是 boolean 值,则返回该 boolean 值,否则返回 false。 |
boolean |
getBoolean(Object key,
Locale l)
如果给定 Locale 的 key 值是 boolean 值,则返回该 boolean 值,否则返回 false。 |
Border |
getBorder(Object key)
如果 key 值为一个 Border ,则返回该 Border,否则返回 null 。 |
Border |
getBorder(Object key,
Locale l)
如果给定 Locale 的 key 值为一个 Border ,则返回该 Border,否则返回 null 。 |
Color |
getColor(Object key)
如果 key 值为一个 Color ,则返回它,否则返回 null 。 |
Color |
getColor(Object key,
Locale l)
如果给定 Locale 的 key 值为一个 Color ,则返回它,否则返回 null 。 |
Locale |
getDefaultLocale()
返回该默认语言环境。 |
Dimension |
getDimension(Object key)
如果 key 值为一个 Dimension ,则返回该 Dimension,否则返回 null 。 |
Dimension |
getDimension(Object key,
Locale l)
如果给定 Locale 的 key 值为一个 Dimension ,则返回该 Dimension,否则返回 null 。 |
Font |
getFont(Object key)
如果 key 值为一个 Font ,则返回该 Font,否则返回 null 。 |
Font |
getFont(Object key,
Locale l)
如果给定 Locale 的 key 值为一个 Font ,则返回它,否则返回 null 。 |
Icon |
getIcon(Object key)
如果 key 值为一个 Icon ,则返回该 Icon,否则返回 null 。 |
Icon |
getIcon(Object key,
Locale l)
如果给定 Locale 的 key 值为一个 Icon ,则返回该 Icon,否则返回 null 。 |
Insets |
getInsets(Object key)
如果 key 值为一个 Insets ,则返回它,否则返回 null 。 |
Insets |
getInsets(Object key,
Locale l)
如果给定 Locale 的 key 值为一个 Insets ,则返回该 Insets,否则返回 null 。 |
int |
getInt(Object key)
如果 key 值为一个 Integer ,则返回该整数值,否则返回 0。 |
int |
getInt(Object key,
Locale l)
如果给定 Locale 的 key 值为一个 Integer ,则返回其整数值,否则返回 0。 |
PropertyChangeListener[] |
getPropertyChangeListeners()
返回使用 addPropertyChangeListener() 添加到此 UIDefaults 的所有 PropertyChangeListener 组成的数组。 |
String |
getString(Object key)
如果 key 值为一个 String ,则返回该 String,否则返回 null 。 |
String |
getString(Object key,
Locale l)
如果给定 Locale 的 key 值为一个 String ,则返回该 String,否则返回 null 。 |
ComponentUI |
getUI(JComponent target)
创建一个指定组件的 ComponentUI 实现。 |
Class<? extends ComponentUI> |
getUIClass(String uiClassID)
返回呈现此组件的 L&F 类。 |
Class<? extends ComponentUI> |
getUIClass(String uiClassID,
ClassLoader uiClassLoader)
get(uidClassID) 的值必须为一个类的 String 名称,该类实现相应的 ComponentUI 类。 |
protected void |
getUIError(String msg)
如果由于某种原因导致 getUI() 失败,则它会在返回 null 之前调用此方法。 |
Object |
put(Object key,
Object value)
将 key 值设置为所有语言环境的 value 。 |
void |
putDefaults(Object[] keyValueList)
将所有键/值对放入数据库中,并无条件地生成一个 PropertyChangeEvent 。 |
void |
removePropertyChangeListener(PropertyChangeListener listener)
从侦听器列表移除一个 PropertyChangeListener 。 |
void |
removeResourceBundle(String bundleName)
从在其中搜索本地化默认的资源包列表中移除一个资源包。 |
void |
setDefaultLocale(Locale l)
设置默认语言环境。 |
从类 java.util.Hashtable 继承的方法 |
---|
clear, clone, contains, containsKey, containsValue, elements, entrySet, equals, hashCode, isEmpty, keys, keySet, putAll, rehash, remove, size, toString, values |
从类 java.lang.Object 继承的方法 |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
构造方法详细信息 |
---|
public UIDefaults()
public UIDefaults(int initialCapacity, float loadFactor)
initialCapacity
- 默认值表的初始容量loadFactor
- 默认值表的加载因子Hashtable
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
- 包含键/值对的对象数组方法详细信息 |
---|
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
的值UIDefaults.LazyValue
,
UIDefaults.ActiveValue
,
Hashtable.get(java.lang.Object)
,
getDefaultLocale()
,
addResourceBundle(java.lang.String)
public Object get(Object key, Locale l)
UIDefaults.LazyValue
,则使用 LazyValue.createValue()
计算其实际值、替换表项并返回实际值。如果该值为 UIDefaults.ActiveValue
,则不替换表项,而是使用每个 get()
调用的 ActiveValue.createValue()
来计算该值。如果未在表中找到该键,则在由此对象维护的资源包中搜索它。使用给定的语言环境首先搜索最近添加的资源包。LazyValues
和 ActiveValues
在资源包中不受支持。
key
- 所需的键l
- 所需的 locale
key
的值UIDefaults.LazyValue
,
UIDefaults.ActiveValue
,
Hashtable.get(java.lang.Object)
,
addResourceBundle(java.lang.String)
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)
public void putDefaults(Object[] keyValueList)
PropertyChangeEvent
。事件 oldValue 和 newValue 将为 null
,而其 propertyName
将为“UIDefaults”。为所有语言环境添加键/值对。
keyValueList
- 键/值对数组put(java.lang.Object, java.lang.Object)
,
Hashtable.put(K, V)
public Font getFont(Object key)
key
值为一个 Font
,则返回该 Font,否则返回 null
。
key
- 所需的键
key
的值为一个 Font
,则返回该 Font
对象;否则返回 null
public Font getFont(Object key, Locale l)
Locale
的 key
值为一个 Font
,则返回它,否则返回 null
。
key
- 所需的键l
- 所需语言环境
key
和 Locale
的值为一个 Font
,则返回该 Font
对象;否则返回 null
public Color getColor(Object key)
key
值为一个 Color
,则返回它,否则返回 null
。
key
- 所需的键
key
的值为一个 Color
,则返回该 Color
对象;否则返回 null
public Color getColor(Object key, Locale l)
Locale
的 key
值为一个 Color
,则返回它,否则返回 null
。
key
- 所需的键l
- 所需的语言环境
key
和 Locale
的值为一个 Color
,则返回该 Color
对象;否则返回 null
public Icon getIcon(Object key)
key
值为一个 Icon
,则返回该 Icon,否则返回 null
。
key
- 所需的键
key
的值为一个 Icon
,则返回该 Icon
对象;否则返回 null
public Icon getIcon(Object key, Locale l)
Locale
的 key
值为一个 Icon
,则返回该 Icon,否则返回 null
。
key
- 所需的键l
- 所需的语言环境
key
和 Locale
的值为一个 Icon
,则返回该 Icon
对象;否则返回 null
public Border getBorder(Object key)
key
值为一个 Border
,则返回该 Border,否则返回 null
。
key
- 所需的键
key
的值为一个 Border
,则返回该 Border
对象;否则返回 null
public Border getBorder(Object key, Locale l)
Locale
的 key
值为一个 Border
,则返回该 Border,否则返回 null
。
key
- 所需的键l
- 所需的语言环境
key
和 Locale
的值为一个 Border
,则返回该 Border
对象;否则返回 null
public String getString(Object key)
key
值为一个 String
,则返回该 String,否则返回 null
。
key
- 所需的键
key
的值为一个 String
,则返回该 String
对象;否则返回 null
public String getString(Object key, Locale l)
Locale
的 key
值为一个 String
,则返回该 String,否则返回 null
。
key
- 所需的键l
- 所需的 Locale
Locale
的 key
的值为一个 String
,则返回该 String
对象;否则返回 null
public int getInt(Object key)
key
值为一个 Integer
,则返回该整数值,否则返回 0。
key
- 所需的键
key
的值为一个 Integer
,则返回其值,否则返回 0public int getInt(Object key, Locale l)
Locale
的 key
值为一个 Integer
,则返回其整数值,否则返回 0。
key
- 所需的键l
- 所需的语言环境
key
和 Locale
的值为一个 Integer
,则返回其值,否则返回 0public boolean getBoolean(Object key)
key
是 boolean 值,则返回该 boolean 值,否则返回 false。
key
- 指定所需 boolean 值的键的 Object
key
值是 boolean 值,则返回该 boolean 值,否则返回 false。public boolean getBoolean(Object key, Locale l)
Locale
的 key
值是 boolean 值,则返回该 boolean 值,否则返回 false。
key
- 一个指定所需 boolean 值的键的 Object
l
- 所需的语言环境
key
和 Locale
的值是 boolean 值,则返回该 boolean 值,否则返回 false。public Insets getInsets(Object key)
key
值为一个 Insets
,则返回它,否则返回 null
。
key
- 所需的键
key
的值为一个 Insets
,则返回该 Insets
对象;否则返回 null
public Insets getInsets(Object key, Locale l)
Locale
的 key
值为一个 Insets
,则返回该 Insets,否则返回 null
。
key
- 所需的键l
- 所需的语言环境
key
和 Locale
的值为一个 Insets
,则返回该 Insets
对象;否则返回 null
public Dimension getDimension(Object key)
key
值为一个 Dimension
,则返回该 Dimension,否则返回 null
。
key
- 所需的键
key
的值为一个 Dimension
,则返回该 Dimension
对象;否则返回 null
public Dimension getDimension(Object key, Locale l)
Locale
的 key
值为一个 Dimension
,则返回该 Dimension,否则返回 null
。
key
- 所需的键l
- 所需的语言环境
key
和 Locale
的值为一个 Dimension
,则返回该 Dimension
对象;否则返回 null
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)
public Class<? extends ComponentUI> getUIClass(String uiClassID)
uiClassID
- 一个包含类 ID 的字符串
getUIClass(uiClassID, null)
返回的类对象protected void getUIError(String msg)
getUI()
失败,则它会在返回 null
之前调用此方法。子类在这里也可以选择执行差不多的操作。
msg
- 要打印的消息字符串getUI(javax.swing.JComponent)
public ComponentUI getUI(JComponent target)
ComponentUI
实现。换句话说,创建 target
的特定于外观的委托对象。此操作分以下两步进行:
target.getUIClassID()
返回的值下的 ComponentUI
实现类的名称。
createUI()
方法构造一个外观代理。
target
- 需要 UI 的 JComponent
ComponentUI
对象public void addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener
。该侦听器是为所有属性注册的。
每更改一个默认值时,都将触发一个 PropertyChangeEvent
。
listener
- 要添加的 PropertyChangeListener
PropertyChangeSupport
public void removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener
。此方法移除了一个为所有属性注册的 PropertyChangeListener
。
listener
- 要移除的 PropertyChangeListener
PropertyChangeSupport
public PropertyChangeListener[] getPropertyChangeListeners()
PropertyChangeListener
组成的数组。
PropertyChangeListener
,如果没有添加侦听器,则返回一个空数组protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
PropertyChangeEvent
x 侦听器列表不为空,则对每个侦听器触发一个 PropertyChange
。
propertyName
- 已更改的属性的编程名称oldValue
- 属性的旧值newValue
- 属性的新值PropertyChangeSupport
public void addResourceBundle(String bundleName)
bundleName
- 要添加的资源包的基本名称ResourceBundle
,
removeResourceBundle(java.lang.String)
public void removeResourceBundle(String bundleName)
bundleName
- 要移除的资源包的基本名称ResourceBundle
,
addResourceBundle(java.lang.String)
public void setDefaultLocale(Locale l)
get
方法,使用默认语言环境检索本地化值。从版本 1.4 开始,Swing UI 对象应该使用其组件的语言环境而不是使用默认语言环境检索本地化值。默认的语言环境可以与 1.4 以前的行为兼容。
l
- 新的默认语言环境getDefaultLocale()
,
get(Object)
,
get(Object,Locale)
public Locale getDefaultLocale()
get
方法,使用默认语言环境检索本地化值。从版本 1.4 开始,Swing UI 对象应该使用其组件的语言环境而不是使用默认语言环境检索本地化值。默认的语言环境可以与 1.4 以前的行为兼容。
setDefaultLocale(java.util.Locale)
,
get(Object)
,
get(Object,Locale)
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。