Java javax.swing.plaf 类 ComponentUI（JDK5）

所有类

javax.swing.plaf
类 ComponentUI

java.lang.Object
  javax.swing.plaf.ComponentUI

直接已知子类：

ButtonUI, ColorChooserUI, ComboBoxUI, DesktopIconUI, DesktopPaneUI, FileChooserUI, InternalFrameUI, LabelUI, ListUI, MenuBarUI, OptionPaneUI, PanelUI, PopupMenuUI, ProgressBarUI, RootPaneUI, ScrollBarUI, ScrollPaneUI, SeparatorUI, SliderUI, SpinnerUI, SplitPaneUI, TabbedPaneUI, TableHeaderUI, TableUI, TextUI, ToolBarUI, ToolTipUI, TreeUI, ViewportUI

public abstract class ComponentUI
   
   
   
   
extends Object
   
   
   
   

用于 Swing 可插入外观架构中所有 UI 委托对象的基本类。Swing 组件的 UI 委托对象负责实现依赖于外观的那些组件的某些方面。为了委托那些可能随所安装的外观而改变的操作（绘制、布局计算等等），JComponent 类要调用来自此类的方法。客户端程序不应在此类上直接调用这些方法。

另请参见：

JComponent, UIManager

ComponentUI

public ComponentUI()

单独的构造方法。（由子类构造方法调用，通常是隐式的）。

installUI

public void installUI(JComponent c)

配置指定组件，使其适合外观。当 ComponentUI 实例将作为 UI 委托安装在指定组件上时，可调用此方法。此方法应该为外观完整地配置组件，包括以下方面：

1. 在组件上安装用于颜色、字体、边框、图标、不透明性等方面的所有默认属性值。只要有可能，就不 应该重写由客户端程序初始化的属性值。
2. 如有必要，可在组件上安装一个 LayoutManager。
3. 将所需的所有子组件创建/添加到组件中。
4. 在组件上创建/安装事件侦听器。
5. 为了检测和适当响应组件属性更改，可在组件上创建/安装一个 PropertyChangeListener。
6. 在组件上安装键盘 UI（助记符、遍历等等）。
7. 初始化任何适当的实例数据。

参数：

c - 将安装此 UI 委托的组件

另请参见：

uninstallUI(javax.swing.JComponent), JComponent.setUI(javax.swing.plaf.ComponentUI), JComponent.updateUI()

uninstallUI

public void uninstallUI(JComponent c)

在 installUI 期间，在指定组件上反向执行的配置操作。当此 UIComponent 实例将作为 UI 委托从指定组件上移除时，可调用此方法。此方法应该取消在 installUI 中执行的配置操作，非常小心地使 JComponent 实例处于某种洁净状态（没有额外的侦听器、没有特定于外观的属性对象等等)。配置内容应该包括以下方面：

1. 从组件中移除所有 UI 设置的边框。
2. 从组件上移除所有 UI 设置的布局管理器。
3. 从组件中移除所有 UI 添加的子组件。
4. 从组件中移除所有 UI 添加的事件/属性侦听器。
5. 从组件中移除所有 UI 安装的键盘 UI。
6. 使所有已分配的实例数据对象无效，从而允许进行 GC 操作。

参数：

c - 从中移除此 UI 委托的组件；此参数常被忽略，但如果 UI 对象是无状态的并由多个组件共享，则可以使用该参数

另请参见：

installUI(javax.swing.JComponent), JComponent.updateUI()

paint

public void paint(Graphics g,
                  JComponent c)

绘制指定组件，使其适合外观。在将要绘制指定组件时，从 ComponentUI.update 方法中调用此方法。子类应该重写此方法并使用指定 Graphics 对象来呈现组件的内容。

参数：

g - 将在其中进行绘制的 Graphics 上下文

c - 将绘制的组件；此参数常被忽略，但如果 UI 对象是无状态的并由多个组件共享，则可以使用该参数

另请参见：

update(java.awt.Graphics, javax.swing.JComponent)

update

public void update(Graphics g,
                   JComponent c)

通知此 UI 委托开始绘制指定的组件。在将要绘制指定组件时，由 JComponent 调用此方法。默认情况下，此方法将使用其背景色填充指定组件（如果其 opaque 属性为 true），然后立刻调用 paint。通常无需由子类重写此方法；所有呈现代码的外观都应位于 paint 方法中。

参数：

g - 将在其中进行绘制的 Graphics 上下文

c - 将绘制的组件；此参数常被忽略，但如果 UI 对象是无状态的并由多个组件共享，则可以使用该参数

另请参见：

paint(java.awt.Graphics, javax.swing.JComponent), JComponent.paintComponent(java.awt.Graphics)

getPreferredSize

public Dimension getPreferredSize(JComponent c)

返回指定组件的适合外观的首选大小。如果返回 null，则首选大小将由组件的布局管理器计算（对于安装了特定布局管理器的组件而言，这是首选方法）。此方法的默认实现返回 null。

参数：

c - 将查询其首选大小的组件；此参数常被忽略，但如果 UI 对象是无状态的并由多个组件共享，则可以使用该参数

另请参见：

JComponent.getPreferredSize(), LayoutManager.preferredLayoutSize(java.awt.Container)

getMinimumSize

public Dimension getMinimumSize(JComponent c)

返回指定组件的适合外观的最小大小。如果返回 null，则最小大小将由组件的布局管理器计算（对于安装了特定布局管理器的组件而言，这是首选方法）。此方法的默认实现调用 getPreferredSize 并返回该值。

参数：

c - 将查询其最小大小的组件；此参数常被忽略，但如果 UI 对象是无状态的并由多个组件共享，则可以使用该参数

返回：

一个 Dimension 对象或 null

另请参见：

JComponent.getMinimumSize(), LayoutManager.minimumLayoutSize(java.awt.Container), getPreferredSize(javax.swing.JComponent)

getMaximumSize

public Dimension getMaximumSize(JComponent c)

返回指定组件的适合外观的最大大小。如果返回 null，则最大大小将由组件的布局管理器计算（对于安装了特定布局管理器的组件而言，这是首选方法）。此方法的默认实现调用 getPreferredSize 并返回该值。

参数：

c - 将查询其最大大小的组件；此参数常被忽略，但如果 UI 对象是无状态的并由多个组件共享，则可以使用该参数

返回：

一个 Dimension 对象或 null

另请参见：

JComponent.getMaximumSize(), LayoutManager2.maximumLayoutSize(java.awt.Container)