Root Pane Container（四）

8.5 JApplet类

JApplet类是AWT Applet类的扩展。为了在使用Swing组件的applet中能正确的进行事件处理，我们applet必须继承JApplet，而不是Applet。

JApplet的作用与其他的实现了RootPaneContainer接口的高层窗口相同。JApplet与Applet之间一个重要的区别就是默认的布局管理器。因为我们向JApplet的内容面析添加组件，其默认的布局管理器为BorderLayout。这与Applet的默认布局管理器FlowLayout不同。另外，Swing applet还可以具有一个工具栏，或者更为特定的JMenuBar，这是applet的JRootPane的另一个属性。

如果我们计划部署一个使用Swing组件的applet，最好是使用Sun Microsystems所提供的Java插件，因为这会随运行时安装Swing库。

如查我们要扩展JApplet类，他只有一个重要的protected方法：

protected JRootPane createRootPane()

8.6 配合桌面使用

Spring提供了对一个通常窗口或是桌面内的窗体集合进行管理。正如我们在第1章所讨论的，这种管理通常被称之为MDI。窗体可以位于其他的窗体之上，或者是可以被拖动，而其外观适当当前的观感。这些窗体是JInternalFrame类的实例，而桌面是一个称之为JDesktopPane的特殊JLayeredPane。桌面内窗体的管理是DesktopManager的责任，其中所提供的默认实现是DefaultDesktopManager。桌面上的JInternalFrame的图标形式是通过JDesktopIcon的内联类JInternalFrame来表示的。同时有InternalFrmaeListener，InternalFrameAdapter以及InternalFrameEvent用于事件处理。

首先，我们来看一下构成桌面的部分，然后我们会看到使用这些部分的一个完整示例。

8.6.1 JInternalFrame类

JInternalFrame类与JFrame类类似。他是一个高层窗口，使用RootPaneContainer接口，但是并不是一个顶层窗口。我们必须将内部窗体放在另一个顶层窗口中。当我们拖动时，内部窗体会停留在其窗口的边界之内，这通常是一个JDesktopPane。另外，内部窗体是轻量级的，并且提供了一个UI委托从而使得内部窗体看起来类似当前配置的观感。

创建JInternalFrame

JInternalFrame有六个构造函数：

public JInternalFrame()
JInternalFrame frame = new JInternalFrame();
 
public JInternalFrame(String title)
JInternalFrame frame = new JInternalFrame("The Title");
 
public JInternalFrame(String title, boolean resizable)
JInternalFrame frame = new JInternalFrame("The Title", true);
 
public JInternalFrame(String title, boolean resizable, boolean closable)
JInternalFrame frame = new JInternalFrame("The Title", false, true);
 
public JInternalFrame(String title, boolean resizable, boolean
  closable, boolean maximizable)
JInternalFrame frame = new JInternalFrame("The Title", true, false, true);
 
public JInternalFrame(String title, boolean resizable, boolean
  closable, boolean maximizable, boolean iconifiable)
JInternalFrame frame = new JInternalFrame("The Title", false, true, false, true);

这些构造函数以一个向另一个添加参数的方式进行级联。无参数时，所创建的JInternalFrame没有标题，并且不能调整大小，关闭，最大化或是图标化。然而，内部窗体总是可以拖动的。

JInternalFrame属性

表8-9列出了JInternalFrame类的30个不同属性。layer属性列出了两次，因为他具有两个设置方法，其中一个用于int，而另一个用于Integer。

JInternalFrame属性

属性名	数据类型	访问性
accessibleContext	AccessibleContext	只读
closable	boolean	读写绑定
closed	boolean	读写绑定
contentPane	Container	读写绑定
defaultCloseOperation	int	读写
desktopIcon	JInternalFrame.JDesktopIcon	读写绑定
desktopPane	JDesktopPane	只读
focusCycleRoot	boolean	读写
focusCycleRootAncester	Container	只读
focusOwner	Component	只读
frameIcon	Icon	读写绑定
glassPane	Component	读写绑定
icon	boolean	读写绑定
iconifiable	boolean	读写
internalFrameListeners	InternalFrameListener[]	只读
jMenuBar	JMenuBar	读写绑定
layer	int	读写
layer	Integer	只写
layeredPane	JLayeredPane	读写绑定
layout	LayoutManager	只写
maximizable	boolean	读写绑定
maximum	boolean	读写
mostRecentFocusOwner	Component	只读
normalBounds	Rectangle	读写
resizable	boolean	读写绑定
rootPane	JRootPane	读写绑定
selected	boolean	读写绑定
title	String	读写绑定
UI	InternalFrameUI	读写
UIClassID	String	只读
warningString	String	只读

对于Java 1.3及以后的版本，JInternalFrame的初始defaultCloseOperation属性设置为DISPOSE_ON_CLOSE。以前版本的默认设置为HIDE_ON_CLOSE。我们可以将这个属性设置为前面的表8-6中列出的WindowConstants的值。

normalBounds属性描述了当一个图标化的内部窗体取消息图标化时应该在哪里显示。focusOwner属性在特定的JInternalFrame被激活时提供了一个实际带有输入焦点的Component。

在Swing类中，JInternalFrame只包含四个限制属性：closed, icon, maximum以及selected。他们与四个boolean构造函数参数直接相关。每一个都可以允许我们在改变其设置时检测当前的属性状态。然而，因为属性是受限制的，当我们要设置一个属性时，我们所做的尝试必须位于一个try-catch块中，捕捉PropertyVetoException：

try {
  // Try to iconify internal frame
  internalFrame.setIcon(false);
}  catch (PropertyVetoException propertyVetoException) {
  System.out.println("Rejected");
}

为了有助于我们使用这些绑定属性，JInternalFrame类定义了一个11个常量，如表8-10所示。他们表示在PropertyChangeListener中通过PropertyChangeEvent的getPropertyName()方法返回的字符串。

JInternal属性常量

属性名常量	关联属性
CONTENT_PANE_PROPERTY	contentPane
FRAME_ICON_PROPERTY	frameIcon
GLASS_PANE_PROPERTY	glassPane
IS_CLOSED_PROPERTY	closed
IS_ICON_PROPERTY	icon
IS_MAXIMUM_PROPERTY	maximum
IS_SELECTED_PROPERTY	selected
LAYERED_PANE_PROPERTY	layeredPane
MENU_BAR_PROPERTY	jMenuBar
ROOT_PANE_PROPERTY	rootPane
TITLE_PROPERTY	title

下面的类示例演示了在PropertyChangeListener中常量的使用。

package swingstudy.ch08;
 
import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;
 
import javax.swing.JInternalFrame;
 
public class InternalFramePropertyChangeHandler implements
		PropertyChangeListener {
 
	@Override
	public void propertyChange(PropertyChangeEvent event) {
		// TODO Auto-generated method stub
 
		String propertyName = event.getPropertyName();
		if(propertyName.equals(JInternalFrame.IS_ICON_PROPERTY)) {
			System.out.println("Icon property changed. React.");
		}
	}
 
}

处理JInternalFrame事件

为了帮助我们像使用JFrame一样来使用JInternalFrame，有一个额外的事件监听器来负责内部窗体的打开与关闭的相关事件。这个接口名为InternalFrameListener，其定义如下。其作用类似于AWT的WindowListener接口，但是所用的JInternalFrame类，而不是AWT的Window类。

public interface InternalFrameListener extends EventListener {
  public void internalFrameActivated(InternalFrameEvent internalFrameEvent);
  public void internalFrameClosed(InternalFrameEvent internalFrameEvent);
  public void internalFrameClosing(InternalFrameEvent internalFrameEvent);
  public void internalFrameDeactivated(InternalFrameEvent internalFrameEvent);
  public void internalFrameDeiconified(InternalFrameEvent internalFrameEvent);
  public void internalFrameIconified(InternalFrameEvent internalFrameEvent);
  public void internalFrameOpened(InternalFrameEvent internalFrameEvent);
}

另外，与具有所有WindowListener方法桩的WindowApapter类类似，也有一个具有所有InternalFrameListener方法桩的InternalFrameAdapter类。如果我们并不是对JInternalFrame发生的所有事件感兴趣，我们可以继承InternalFrameAdapter类，并且只重写我们所感兴趣的方法。例如，列表8-5中所示的监听器只对图标化方法感兴趣。无需提供InternalFrameListener的其他五个方法的桩实现，我们只需要继承InternalFrameAdapter，并重写两个相关的方法。

package swingstudy.ch08;
 
import javax.swing.JInternalFrame;
import javax.swing.event.InternalFrameAdapter;
import javax.swing.event.InternalFrameEvent;
 
public class InternalFrameIconifyListener extends InternalFrameAdapter {
 
	public void internalFrameIconified(InternalFrameEvent event) {
		JInternalFrame source = (JInternalFrame)event.getSource();
		System.out.println("Iconified: "+source.getTitle());
	}
 
	public void internalFrameDeiconified(InternalFrameEvent event) {
		JInternalFrame source = (JInternalFrame)event.getSource();
		System.out.println("Deiconified: "+source.getTitle());
	}
}

InternalFrameEvent是AWTEvent的子类。为了定义由AWTEvent的public int getID()方法返回的值，InternalFrameEvent每一个可用的特定事件子类定义了一个常量。表8-11列出了九个常量。我们也可以通过事件的getInternalFrame()方法来获得实际的JInternalFrame。

InternalFrameEvent事件子类型

事件子类型ID	关联的接口方法
INTERNAL_FRAME_ACTIVATED	internalFrameActivated
INTERNAL_FRAME_CLOSED	internalFrameClosed
INTERNAL_FRAME_CLOSING	internalFrameClosing
INTERNAL_FRAME_DEACTIVATED	internalFrameDeactivated
INTERNAL_FRAME_DEICONIFIED	internalFrameDeiconified
INTERNAL_FRAME_FIRST	N/A
INTERNAL_FRAME_ICONIFIED	internalFrameIconified
INTERNAL_FRAME_LAST	N/A
INTERNAL_FRAME_OPENED	internalFrameOpened

自定义JInternalFrame观感

因为JInternalFrame是一个轻量级组件，他具有可安装的观感。每一个可安装的Swing观感提供了一个不同的JInternalFrame外观以及默认的UIResource值集合。图8-5预安装的观感类型集合的JWindow窗口外观。

表8-12中列出了JInternalFrame的可用UIResource相关属性的集合。对于JInternalFrame常量，有60个不同的属性，包括内部窗体的标题面板的属性。

JInternalFrame UIResource元素

属性字符串	对象类型
InternalFrame.actionMap	ActionMap
InternalFrame.activeBroderColor	Color
InternalFrame.activeTitleBackground	Color
InternaleFrame.activeTitleForeground	Color
InternalFrame.activeTitleGradient	List
InternalFrame.border	Border
InternalFrame.borderColor	Color
InternalFrame.borderDarkShadow	Color
InternalFrame.borderHighlight	Color
InterenalFrame.borderLight	Color
InternaleFrame.borderShadow	Color
InternaleFrame.borderWidth	Integer
InternalFrame.closeButtonToolTip	String
InternalFrame.closeIcon	Icon
InternalFrmae.closeSound	String
InternalFrame.icon	Icon
InternalFrame.iconButtonToolTip	String
InternalFrame.iconifyIcon	Icon
InternalFrame.inactiveBorderColor	Color
InternalFrame.inactiveTitleBackground	Color
InternalFrame.inactiveTitleForeground	Color
InternalFrame.inactiveTitleGradient	List
InternalFrame.layoutTitlePaneAtOrigin	Boolean
InternalFrame.maxButtonToolTip	String
InternalFrame.maximizeIcon	Icon
InternalFrame.maximizeSound	String
InternalFrame.minimizeIcon	Icon
InternalFrame.minimizeIconBackground	Color
InternalFrame.minimizeSound	String
InternalFrame.optionDialogBorder	Border
InternalFrame.paletteBorder	Border
InternalFrame.paletteCloseIcon	Icon
InternalFrame.paletteTitleHeight	Integer
InternaleFrame.resizeIconHighlight	Color
InternalFrame.resizeIconShadow	Color
InternalFrame.restoreButtonToolTip	String
InternalFrame.restoreDownSound	String
InternalFrame.restoreUpSound	String
InternalFrame.titlebuttonHeight	Integer
InternalFrame.titleButtonWidth	Integer
InternalFrame.titleFont	Font
InternalFrame.titlePaneHeight	Integer
InternalFrame.useTaskBar	Boolean
InternalFrame.windowBindings	Object[]
InternalFrameTitlePane.closebuttonAccessibleName	String
InternalFrameTitlePane.closebuttonText	String
InternalFrameTitlePane.closeIcon	Icon
InternalFrameTitlePane.iconifyButtonAccessibleName	String
InternalFrameTitlePane.iconifyIcon	Icon
InternalFrameTitlePane.maximizeButtonAccessiblName	String
InternalFrameTitlePane.maximizeButtonText	String
InternalFrameTitlePane.minimizeIcon	Icon
InternalFrameTitlePane.moveButtonText	String
InternalFrameTitlePane.restoreButtonText	String
InternalFrameTitlePane.sizeButtonText	String
InternalFrameTitlePane.titlePaneLayout	LayoutManager
InternalFrameTitlePaneUI	String
InternalFrameUI	String

除了表8-12中许多可配置属性以外，对于Metal观感，我们还可以通过特殊的客户端属性JInternalFrame.isPalette来将内部窗体设计为一个palette。当设置为Boolean.TRUE时，内部窗体的外观会与其他窗体略微不同，并且具有较短的标题栏，如图8-6所示。

如果我们同时在桌面的PALETTE_LAYER上添加了一个内部窗体，则这个窗体会位于其他所有窗体之上（如图8-6所示）：

JInternalFrame palette = new JInternalFrame("Palette", true, false, true, false);
palette.setBounds(150, 0, 100, 100);
palette.putClientProperty("JInternalFrame.isPalette", Boolean.TRUE);
desktop.add(palette, JDesktopPane.PALETTE_LAYER);

创建图8-6所示的程序的完整代码显示在本章稍后的列表8-6中。

修改JDesktopIcon

JInternalFrame依赖一个内联类JDesktopIcon来为JInternalFrame的图标化显示提供UI委托。这个类只是用来这种功能的一个特殊的JComponent，而不是如其名字暗示的一个特殊的Icon实现。事实上，JDesktopIcon类的注释表明这个类是临时的，所以我们不应直接对其进行自定义。（当然，这个类会存在一段时间。）

如果我们需要自定义JDesktopIcon，我们可以修改一些UIResource相关的属性。表8-13列出了JDesktopIcon组件的八个UIResource相关属性。

JInternalFrame.JDesktopIcon UIResource元素

属性字符串	对象类型
DesktopIcon.background	Color
DesktopIcon.border	Border
DesktopIcon.font	Font
DesktopIcon.foreground	Color
DesktopIcon.icon	Icon
DesktopIcon.width	Integer
DesktopIcon.windowBindings	Object[]
DesktopIconUI	String

8.6.2 JDesktopPane类

与内部窗体组合配合使用的另一个类就是JDesktopPane类。桌面面板的目的就是包含内部窗体集合。当内部窗体被包含在一个桌面面板中时，他们将其行为的大部分委托给桌面面板的桌面管理器。我们将会在本章稍后详细了解DesktopManager接口。

创建JDesktopPane

JDesktopPane只有一个无参数的构造函数。一旦创建，我们通常将其放在由BorderLayout管理的容器的中部。这可以保证桌面占据容器的所有空间。

将内部窗体添加到JDesktopPane

JDesktopPane并没有实现RootPaneContainer。我们并不能直接将组件添加到JRootPane内的不同面板中，而是直接将其添加到JDesktopPane：

desktop.add(anInternalFrame);

JDesktopPane属性

如表8-14所示，JDesktopPane有八个属性。位于allFrames属性数组索引0外的JInternalFrame是位于桌面前面的内部窗体（JInternalFrame f = desktop.getAllFrames()[0]）。除了获取JDesktopPane中的所有窗体以外，我们还可以仅获取特定层的窗体：public JInternalFrame[] getAllFramesInLayer(int layer)。

可用的dragMode属性设置可以为类的LIVE_DRAG_MODE与OUTLINE_DRAG_MODE常量。

JDesktopPane属性

属性名	数据类型	访问性
accessibleContext	AccessibleContext	只读
allFrames	JInternalFrame[]	只读
desktopManager	DesktopManager	读写
dragMode	int	读写绑定
opaque	boolean	只读
selectedFrame	JInternalFrame	读写
UI	DesktopPaneUI	读写
UIClassID	String	只读

自定义JDesktopPane观感

回到图8-5，我们可以看到JDesktopPane中的JInternalFrame对象。JDesktopPane的基本观感与每一个观感相同。如表8-15所示，对JDesktopPane并没有太多可以配置的UIResource相关属性。

JDesktopPane UIResource元素

属性字符串	对象类型
desktop	Color
Desktop.ancestorInputMap	InputMap
Desktop.background	Color
Desktop.windowBindings	Object[]
DesktopPane.actionMap	ActionMap
DesktopPaneUI	String

完整的桌面示例

现在我们已经了解了主要的桌面相关类，现在我们来看一下完整的示例。基本的过程包括创建一组JInternalFrame对象，然后将放在一个JDesktopPane中。如果需要，可以对每一个内部窗体的单个组件进行事件处理，也可以对单个窗体进行事件处理。在这个示例中简单的使用了前面的列表8-5中所给出的InternalFrameIconifyListener类来监听正在图标化和取消图标化的内容窗体。

图8-6显示了程序启动时的样子。一个特定的内部窗体被设计为palette，并且允许了拖放模式。

列表8-6显示了这个示例的完整代码。

package swingstudy.ch08;
 
import java.awt.BorderLayout;
import java.awt.EventQueue;
 
import javax.swing.JDesktopPane;
import javax.swing.JFrame;
import javax.swing.JInternalFrame;
import javax.swing.JLabel;
import javax.swing.event.InternalFrameListener;
 
public class DesktopSample {
 
	/**
	 * @param args
	 */
	public static void main(final String[] args) {
		// TODO Auto-generated method stub
 
		Runnable runner = new Runnable() {
			public void run() {
				String title = (args.length==0 ? "Desktop Sample" : args[0]);
				JFrame frame = new JFrame(title);
				frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
 
				JDesktopPane desktop = new JDesktopPane();
				JInternalFrame internalFrames[] = {
						new JInternalFrame("Can Do All", true, true, true, true),
						new JInternalFrame("Not Resizable", false, true, true, true),
						new JInternalFrame("Not Closable", true, false, true, true),
						new JInternalFrame("Not Maximizable", true, true, false, true),
						new JInternalFrame("Not Iconifiable", true, true, true, false)
				};
 
				InternalFrameListener internalFrameListener = new InternalFrameIconifyListener();
 
				int pos = 0;
				for(JInternalFrame internalFrame: internalFrames) {
					// Add to desktop
					desktop.add(internalFrame);
 
					// Position and size
					internalFrame.setBounds(pos*25, pos*25, 200, 100);
					pos++;
 
					// Add listener for iconification events
					internalFrame.addInternalFrameListener(internalFrameListener);
 
					JLabel label = new JLabel(internalFrame.getTitle(), JLabel.CENTER);
					internalFrame.add(label, BorderLayout.CENTER);
 
					// Make visible
					internalFrame.setVisible(true);
 
				}
 
				JInternalFrame palette = new JInternalFrame("Palette", true, false, true, false);
				palette.setBounds(350, 150, 100, 100);
				palette.putClientProperty("JInternalFrame.isPalette", Boolean.TRUE);
				desktop.add(palette, JDesktopPane.PALETTE_LAYER);
				palette.setVisible(true);
 
				desktop.setDragMode(JDesktopPane.OUTLINE_DRAG_MODE);
 
				frame.add(desktop, BorderLayout.CENTER);
				frame.setSize(500, 300);
				frame.setVisible(true);
			}
		};
 
		EventQueue.invokeLater(runner);
	}
 
}

DesktopManager接口

使用桌面的最后一部分就是桌面管理器了，他是DesktopManager接口的实现，其定义如下：

当JInternalFrame位于JDe

public interface DesktopManager {
  public void activateFrame(JInternalFrame frame);
  public void beginDraggingFrame(JComponent frame);
  public void beginResizingFrame(JComponent frame, int direction);
  public void closeFrame(JInternalFrame frame);
  public void deactivateFrame(JInternalFrame frame);
  public void deiconifyFrame(JInternalFrame frame);
  public void dragFrame(JComponent frame, int newX, int newY);
  public void endDraggingFrame(JComponent frame);
  public void endResizingFrame(JComponent frame);
  public void iconifyFrame(JInternalFrame frame);
  public void maximizeFrame(JInternalFrame frame);
  public void minimizeFrame(JInternalFrame frame);
  public void openFrame(JInternalFrame frame);
  public void resizeFrame(JComponent frame, int newX, int newY, int newWidth,
    int newHeight);
  public void setBoundsForFrame(JComponent frame, int newX, int newY, int newWidth,
    int newHeight);
}

sktopPane中时，他们不应尝试例如图标化或是最大化的操作。相反，他们应该请求他们所安装在的桌面面板的桌面管理器来执行这些操作：

getDesktopPane().getDesktopManager().iconifyFrame(anInternalFrame);

DefaultDesktopManager类提供了DesktopManager的一个实现。如果默认实现还足够，观感会提供他们自己的DesktopManager实现类，例如Windows观感的WindowsDesktopManager。我们也可以定义自己的管理器，但是通常并不需要这样。

8.7 小结

在本章中，我们探讨了JRootPane类，以及如何实现依据JRootPane对内部组件进行管理的RootPaneContainer接口。我们同时了解了在Swing中我们如何使用JFrame, JDialog, JWindow, JApplet或是JInternalFrame类的JRootPane。根面板可以借助JLayeredPane来布局组件，其方式是工具提示文本以及弹出菜单总是显示在相关联组件的上面。

JInternalFrame同时也可以存在于桌面环境中，在这种情况下，JDesktopPane以及DesktopManager管理如何以及在哪里放置并显示内部窗体。我们还可以通过将InternalFrameListener实现也JInternalFrame关联来响应内部窗体事件。

在第9章中，我们将会探讨Swing库中的特定弹出组件：JColorChooser, JFileChooser， JOptionPane以及ProgressMonitor。