JavaTM 2 Platform
Standard Ed. 5.0

javax.swing
类 UIManager

java.lang.Object
  继承者 javax.swing.UIManager
所有已实现的接口:
Serializable

public class UIManager
extends Object
implements Serializable

此类跟踪当前的外观及其默认设置。按下列方式选择默认外观类:

  1. 如果系统属性 swing.defaultlaf 为非 null,则将其用作默认外观类名称。
  2. 如果 Properties 文件 swing.properties 存在且包含键 swing.defaultlaf,则将其值用作默认外观类名称。swing.properties 的位置可能随 Java 平台的实现而不同。在 Sun 的实现中,这将驻留在 &java.home>/lib/swing.properties 中。有关更详细的信息,请参阅您正在使用的实现的发行说明。
  3. 否则,请使用 Java look and feel。

我们管理下列三个级别的默认设置:用户默认、外观默认、系统默认。调用 UIManager.get 将按顺序检查所有三个级别,并返回第一个非 null 键值(如果有)。调用 UIManager.put 只影响用户默认设置。注意,调用 setLookAndFeel 不影响用户默认设置,它只替换中间默认“级别”。

警告:此类的序列化对象将与以后的 Swing 版本不兼容。当前的序列化支持适用于短期存储或运行同一版本 Swing 的应用程序之间的 RMI。从 1.4 版本开始,已在 java.beans 包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder

另请参见:
javax.swing.plaf.metal

嵌套类摘要
static class UIManager.LookAndFeelInfo
          为了配置菜单或为了初始应用程序设置而提供关于已安装的 LookAndFeel 的少量信息。
 
构造方法摘要
UIManager()
           
 
方法摘要
static void addAuxiliaryLookAndFeel(LookAndFeel laf)
          将 LookAndFeel 添加到辅助外观的列表中。
static void addPropertyChangeListener(PropertyChangeListener listener)
          将一个 PropertyChangeListener 添加到侦听器列表。
static Object get(Object key)
          从默认表中返回一个对象。
static Object get(Object key, Locale l)
          从适合给定语言环境的默认表中返回一个对象。
static LookAndFeel[] getAuxiliaryLookAndFeels()
          返回辅助外观的列表(可以为 null)。
static boolean getBoolean(Object key)
          从与键值相关的默认表中返回一个布尔变量。
static boolean getBoolean(Object key, Locale l)
          从与键值和给定的 Locale 相关的默认表中返回一个布尔变量。
static Border getBorder(Object key)
          从默认表中返回一个边框。
static Border getBorder(Object key, Locale l)
          从适合给定语言环境的默认表中返回一个边框。
static Color getColor(Object key)
          从默认表中返回一种绘制颜色。
static Color getColor(Object key, Locale l)
          从适合给定语言环境的默认表中返回一种绘制颜色。
static String getCrossPlatformLookAndFeelClassName()
          返回实现默认的跨平台外观 -- Java Look and Feel (JLF) -- 的 LookAndFeel 类的名称。
static UIDefaults getDefaults()
          返回此外观的默认值。
static Dimension getDimension(Object key)
          从默认表中返回一个维数。
static Dimension getDimension(Object key, Locale l)
          从适合给定语言环境的默认表中返回一个维数。
static Font getFont(Object key)
          从默认表中返回一种绘制字体。
static Font getFont(Object key, Locale l)
          从适合给定语言环境的默认表中返回一种绘制字体。
static Icon getIcon(Object key)
          从默认表中返回一个 Icon
static Icon getIcon(Object key, Locale l)
          从适合给定语言环境的默认表中返回一个 Icon
static Insets getInsets(Object key)
          从默认表中返回一个 Insets 对象。
static Insets getInsets(Object key, Locale l)
          从适合给定语言环境的默认表中返回一个 Insets 对象。
static UIManager.LookAndFeelInfo[] getInstalledLookAndFeels()
          返回提供有关 LookAndFeel 实现的一些信息的对象的数组,该实现已使用此软件开发工具包安装。
static int getInt(Object key)
          从默认表中返回一个整数。
static int getInt(Object key, Locale l)
          从适合给定语言环境的默认表中返回一个整数。
static LookAndFeel getLookAndFeel()
          返回当前的默认外观,或返回 null
static UIDefaults getLookAndFeelDefaults()
          返回此外观的默认值。
static PropertyChangeListener[] getPropertyChangeListeners()
          返回添加到此 UIManager(具有 addPropertyChangeListener())的所有 PropertyChangeListener 的数组。
static String getString(Object key)
          从默认表中返回一个字符串。
static String getString(Object key, Locale l)
          从适合给定语言环境的默认表中返回一个字符串。
static String getSystemLookAndFeelClassName()
          返回实现本机系统外观(如果有一个)的 LookAndFeel 类的名称,否则返回默认的跨平台 LookAndFeel 类的名称。
static ComponentUI getUI(JComponent target)
          返回呈现目标组件的 L&F 对象。
static void installLookAndFeel(String name, String className)
          创建一个新的外观并将其添加到当前数组。
static void installLookAndFeel(UIManager.LookAndFeelInfo info)
          将指定的外观添加到当前数组中,然后调用 setInstalledLookAndFeels(javax.swing.UIManager.LookAndFeelInfo[])
static Object put(Object key, Object value)
          在默认表中存储一个对象。
static boolean removeAuxiliaryLookAndFeel(LookAndFeel laf)
          从辅助外观列表移除一个 LookAndFeel
static void removePropertyChangeListener(PropertyChangeListener listener)
          从侦听器列表移除 PropertyChangeListener
static void setInstalledLookAndFeels(UIManager.LookAndFeelInfo[] infos)
          替换已安装的 LookAndFeelInfos 的当前数组。
static void setLookAndFeel(LookAndFeel newLookAndFeel)
          使用 LookAndFeel 对象设置当前的默认外观。
static void setLookAndFeel(String className)
          使用一个类名称设置当前的默认外观。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

UIManager

public UIManager()
方法详细信息

getInstalledLookAndFeels

public static UIManager.LookAndFeelInfo[] getInstalledLookAndFeels()
返回提供有关 LookAndFeel 实现的一些信息的对象的数组,该实现已使用此软件开发工具包安装。应用程序可以使用 LookAndFeel info 对象为用户构造外观选项的菜单,或在启动时设置该外观。注意,我们不会在此处返回 LookAndFeel 类本身来避免不必要的加载这些类带来的成本。

在给定 LookAndFeelInfo 对象的情况下,可以按下面的方式设置当前外观:

 UIManager.setLookAndFeel(info.getClassName());
 

返回:
LookAndFeelInfo 对象的数组
另请参见:
setLookAndFeel(javax.swing.LookAndFeel)

setInstalledLookAndFeels

public static void setInstalledLookAndFeels(UIManager.LookAndFeelInfo[] infos)
                                     throws SecurityException
替换已安装的 LookAndFeelInfos 的当前数组。

参数:
infos - LookAndFeelInfo 的新数组
抛出:
SecurityException
另请参见:
getInstalledLookAndFeels()

installLookAndFeel

public static void installLookAndFeel(UIManager.LookAndFeelInfo info)
将指定的外观添加到当前数组中,然后调用 setInstalledLookAndFeels(javax.swing.UIManager.LookAndFeelInfo[])

参数:
info - 命名外观并标识实现它的类的 LookAndFeelInfo 对象

installLookAndFeel

public static void installLookAndFeel(String name,
                                      String className)
创建一个新的外观并将其添加到当前数组。然后调用 setInstalledLookAndFeels(javax.swing.UIManager.LookAndFeelInfo[])

参数:
name - 指定该外观的名称的 String
className - 指定实现该外观的类名称的 String

getLookAndFeel

public static LookAndFeel getLookAndFeel()
返回当前的默认外观,或返回 null

返回:
当前的默认外观,或返回 null
另请参见:
setLookAndFeel(javax.swing.LookAndFeel)

setLookAndFeel

public static void setLookAndFeel(LookAndFeel newLookAndFeel)
                           throws UnsupportedLookAndFeelException
使用 LookAndFeel 对象设置当前的默认外观。

这是一个 JavaBeans bound 属性。

参数:
newLookAndFeel - 该 LookAndFeel 对象
抛出:
UnsupportedLookAndFeelException - 如果 lnf.isSupportedLookAndFeel() 为 false
另请参见:
getLookAndFeel()

setLookAndFeel

public static void setLookAndFeel(String className)
                           throws ClassNotFoundException,
                                  InstantiationException,
                                  IllegalAccessException,
                                  UnsupportedLookAndFeelException
使用一个类名称设置当前的默认外观。

参数:
className - 指定实现外观的类名称的字符串
抛出:
ClassNotFoundException - 如果无法找到 LookAndFeel
InstantiationException - 如果无法创建一个该类的新实例
IllegalAccessException - 如果该类或初始化程序不可访问
UnsupportedLookAndFeelException - 如果 lnf.isSupportedLookAndFeel() 为 false

getSystemLookAndFeelClassName

public static String getSystemLookAndFeelClassName()
返回实现本机系统外观(如果有一个)的 LookAndFeel 类的名称,否则返回默认的跨平台 LookAndFeel 类的名称。如果已定义了系统属性 swing.systemlaf,则返回其值。

返回:
LookAndFeel 类的 String
另请参见:
setLookAndFeel(javax.swing.LookAndFeel), getCrossPlatformLookAndFeelClassName()

getCrossPlatformLookAndFeelClassName

public static String getCrossPlatformLookAndFeelClassName()
返回实现默认的跨平台外观 -- Java Look and Feel (JLF) -- 的 LookAndFeel 类的名称。如果已定义了系统属性 swing.systemlaf,则返回其值。

返回:
带有 JLF 实现类的字符串
另请参见:
setLookAndFeel(javax.swing.LookAndFeel), getSystemLookAndFeelClassName()

getDefaults

public static UIDefaults getDefaults()
返回此外观的默认值。

返回:
包含该默认值的 UIDefaults 对象

getFont

public static Font getFont(Object key)
从默认表中返回一种绘制字体。

参数:
key - 指定该字体的 Object
返回:
Font 对象

getFont

public static Font getFont(Object key,
                           Locale l)
从适合给定语言环境的默认表中返回一种绘制字体。

参数:
key - 指定字体的 Object
l - 需要该字体的 Locale
返回:
Font 对象
从以下版本开始:
1.4

getColor

public static Color getColor(Object key)
从默认表中返回一种绘制颜色。

参数:
key - 指定该颜色的 Object
返回:
Color 对象

getColor

public static Color getColor(Object key,
                             Locale l)
从适合给定语言环境的默认表中返回一种绘制颜色。

参数:
key - 指定该颜色的 Object
l - 需要该颜色的 Locale
返回:
Color 对象
从以下版本开始:
1.4

getIcon

public static Icon getIcon(Object key)
从默认表中返回一个 Icon

参数:
key - 指定该图标的 Object
返回:
Icon 对象

getIcon

public static Icon getIcon(Object key,
                           Locale l)
从适合给定语言环境的默认表中返回一个 Icon

参数:
key - 指定该图标的 Object
l - 需要该图标的 Locale
返回:
Icon 对象
从以下版本开始:
1.4

getBorder

public static Border getBorder(Object key)
从默认表中返回一个边框。

参数:
key - 指定该边框的 Object
返回:
Border 对象

getBorder

public static Border getBorder(Object key,
                               Locale l)
从适合给定语言环境的默认表中返回一个边框。

参数:
key - 指定该边框的 Object
l - 需要该边框的 Locale
返回:
Border 对象
从以下版本开始:
1.4

getString

public static String getString(Object key)
从默认表中返回一个字符串。

参数:
key - 指定该字符串的 Object
返回:
String

getString

public static String getString(Object key,
                               Locale l)
从适合给定语言环境的默认表中返回一个字符串。

参数:
key - 指定该字符串的 Object
l - 需要该字符串的 Locale
返回:
String

getInt

public static int getInt(Object key)
从默认表中返回一个整数。

参数:
key - 指定该 int 值的 Object
返回:
该 int 值

getInt

public static int getInt(Object key,
                         Locale l)
从适合给定语言环境的默认表中返回一个整数。

参数:
key - 指定该 int 值的 Object
l - 需要该 int 值的 Locale
返回:
该 int 值
从以下版本开始:
1.4

getBoolean

public static boolean getBoolean(Object key)
从与键值相关的默认表中返回一个布尔变量。如果找不到键或该键不表示布尔值,则返回 false。

参数:
key - 指定所需布尔值的键的 Object
返回:
对应于该键的布尔值
从以下版本开始:
1.4

getBoolean

public static boolean getBoolean(Object key,
                                 Locale l)
从与键值和给定的 Locale 相关的默认表中返回一个布尔变量。如果找不到键或该键不表示布尔值,则返回 false。

参数:
key - 指定所需布尔值的键的 Object
l - 需要该布尔变量的 Locale
返回:
对应于该键的布尔值
从以下版本开始:
1.4

getInsets

public static Insets getInsets(Object key)
从默认表中返回一个 Insets 对象。

参数:
key - 指定该 Insets 对象的 Object
返回:
Insets 对象

getInsets

public static Insets getInsets(Object key,
                               Locale l)
从适合给定语言环境的默认表中返回一个 Insets 对象。

参数:
key - 指定该 Insets 对象的 Object
l - 需要该对象的 Locale
返回:
Insets 对象
从以下版本开始:
1.4

getDimension

public static Dimension getDimension(Object key)
从默认表中返回一个维数。

参数:
key - 指定维数对象的 Object
返回:
Dimension 对象

getDimension

public static Dimension getDimension(Object key,
                                     Locale l)
从适合给定语言环境的默认表中返回一个维数。

参数:
key - 指定该维数对象的 Object
l - 需要该对象的 Locale
返回:
Dimension 对象
从以下版本开始:
1.4

get

public static Object get(Object key)
从默认表中返回一个对象。

参数:
key - 指定所需对象的 Object
返回:
Object

get

public static Object get(Object key,
                         Locale l)
从适合给定语言环境的默认表中返回一个对象。

参数:
key - 指定所需对象的 Object
l - 需要该对象的 Locale
返回:
Object

put

public static Object put(Object key,
                         Object value)
在默认表中存储一个对象。

参数:
key - 一个指定检索键的 Object
value - 要存储的 Object
返回:
UIDefaults.put(java.lang.Object, java.lang.Object) 返回的 Object

getUI

public static ComponentUI getUI(JComponent target)
返回呈现目标组件的 L&F 对象。

参数:
target - 要呈现的 JComponent
返回:
呈现目标组件的 ComponentUI 对象

getLookAndFeelDefaults

public static UIDefaults getLookAndFeelDefaults()
返回此外观的默认值。

返回:
一个包含该默认值的 UIDefaults 对象

addAuxiliaryLookAndFeel

public static void addAuxiliaryLookAndFeel(LookAndFeel laf)
LookAndFeel 添加到辅助外观的列表中。这些辅助外观会告知多路外观,在创建多路 UI 时除默认的 LookAndFeel 类外还使用其他哪些 LookAndFeel 类。该项更改只有在创建新的 UI 类或在组件实例上更改默认外观时生效。

注意,这些类不同于已安装的外观。

参数:
laf - 该 LookAndFeel 对象
另请参见:
removeAuxiliaryLookAndFeel(javax.swing.LookAndFeel), setLookAndFeel(javax.swing.LookAndFeel), getAuxiliaryLookAndFeels(), getInstalledLookAndFeels()

removeAuxiliaryLookAndFeel

public static boolean removeAuxiliaryLookAndFeel(LookAndFeel laf)
从辅助外观列表移除一个 LookAndFeel。这些辅助外观会告知多路外观,在创建多路 UI 时除默认的 LookAndFeel 类外还使用其他哪些 LookAndFeel 类。该项更改只有在创建新的 UI 类或在组件实例上更改默认外观时生效。

注意,这些类不同于已安装的外观。

返回:
如果该 LookAndFeel 已从列表移除,则返回 true
另请参见:
removeAuxiliaryLookAndFeel(javax.swing.LookAndFeel), getAuxiliaryLookAndFeels(), setLookAndFeel(javax.swing.LookAndFeel), getInstalledLookAndFeels()

getAuxiliaryLookAndFeels

public static LookAndFeel[] getAuxiliaryLookAndFeels()
返回辅助外观的列表(可以为 null)。这些辅助的外观告知多路外观,在创建多路 UI 时除默认的 LookAndFeel 类外还使用其他哪些 LookAndFeel 类。

注意,这些类不同于已安装的外观。

返回:
辅助 LookAndFeel 的列表,或返回 null
另请参见:
addAuxiliaryLookAndFeel(javax.swing.LookAndFeel), removeAuxiliaryLookAndFeel(javax.swing.LookAndFeel), setLookAndFeel(javax.swing.LookAndFeel), getInstalledLookAndFeels()

addPropertyChangeListener

public static void addPropertyChangeListener(PropertyChangeListener listener)
将一个 PropertyChangeListener 添加到侦听器列表。该侦听器为所有属性进行注册。

参数:
listener - 要添加的 PropertyChangeListener
另请参见:
PropertyChangeSupport

removePropertyChangeListener

public static void removePropertyChangeListener(PropertyChangeListener listener)
从侦听器列表移除 PropertyChangeListener。此方法移除了一个为所有属性注册的 PropertyChangeListener

参数:
listener - 要移除的 PropertyChangeListener
另请参见:
PropertyChangeSupport

getPropertyChangeListeners

public static PropertyChangeListener[] getPropertyChangeListeners()
返回添加到此 UIManager(具有 addPropertyChangeListener())的所有 PropertyChangeListener 的数组。

返回:
添加的所有 PropertyChangeListener;如果没有添加侦听器,则返回一个空数组
从以下版本开始:
1.4

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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