当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

UIManager (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助		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 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 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. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。