javax.swing
类 JDesktopPane

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JLayeredPane
                  javax.swing.JDesktopPane

所有已实现的接口：

ImageObserver, MenuContainer, Serializable, Accessible

public class JDesktopPane
extends JLayeredPane
implements Accessible

用于创建多文档界面或虚拟桌面的容器。用户可创建 JInternalFrame 对象并将其添加到 JDesktopPane。JDesktopPane 扩展了 JLayeredPane，以管理可能的重叠内部窗体。它还维护了对 DesktopManager 实例的引用，这是由 UI 类为当前的外观 (L&F) 所设置的。注意，JDesktopPane 不支持边界。

此类通常用作 JInternalFrames 的父类，为 JInternalFrames 提供一个可插入的 DesktopManager 对象。特定于 L&F 的实现 installUI 负责正确设置 desktopManager 变量。JInternalFrame 的父类是 JDesktopPane 时，它应该将其大部分行为（关闭、调整大小等）委托给 desktopManager。

有关此内容更多的文档和示例，请参阅 The Java Tutorial 的 How to Use Internal Frames 一节。

警告： Swing 不是线程安全的。有关更多信息，请参阅 Swing's Threading Policy。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

另请参见：

JInternalFrame, JInternalFrame.JDesktopIcon, DesktopManager

LIVE_DRAG_MODE

public static final int LIVE_DRAG_MODE

指示正在被拖动项的所有内容是否应该出现在桌面窗格内部。

另请参见：

OUTLINE_DRAG_MODE, setDragMode(int), 常量字段值

OUTLINE_DRAG_MODE

public static final int OUTLINE_DRAG_MODE

指示桌面窗格是否只应该出现正在被拖动项的轮廓。

另请参见：

LIVE_DRAG_MODE, setDragMode(int), 常量字段值

JDesktopPane

public JDesktopPane()

创建一个新的 JDesktopPane。

getUI

public DesktopPaneUI getUI()

返回呈现此组件的 L&F 对象。

返回：

呈现此组件的 DesktopPaneUI 对象

setUI

public void setUI(DesktopPaneUI ui)

设置呈现此组件的 L&F 对象。

参数：

ui - DesktopPaneUI L&F 对象

另请参见：

UIDefaults.getUI(javax.swing.JComponent)

setDragMode

public void setDragMode(int dragMode)

设置桌面窗格使用的“拖动样式”。出于性能或审美的原因，可能要更改模式。

参数：

dragMode - 为 Desktop 中各项所用的拖动样式

从以下版本开始：

1.3

另请参见：

LIVE_DRAG_MODE, OUTLINE_DRAG_MODE

getDragMode

public int getDragMode()

获取桌面窗格当前使用的“拖动样式”。

返回：

Live_DRAG_MODE 或 OUTLINE_DRAG_MODE

从以下版本开始：

1.3

另请参见：

setDragMode(int)

getDesktopManager

public DesktopManager getDesktopManager()

返回处理特定于桌面 UI 操作的 DesktopManger。

setDesktopManager

public void setDesktopManager(DesktopManager d)

设置处理特定于桌面 UI 操作的 DesktopManger。

参数：

d - 所使用的 DesktopManager

updateUI

public void updateUI()

UIManager 发出的关于 L&F 已更改的通知。用来自 UIManager 的最新版本 UI 对象替换当前的 UI 对象。

覆盖：

类 JComponent 中的 updateUI

另请参见：

JComponent.updateUI()

getUIClassID

public String getUIClassID()

返回呈现此组件的 L&F 类名。

覆盖：

类 JComponent 中的 getUIClassID

返回：

字符串 "DesktopPaneUI"

另请参见：

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

getAllFrames

public JInternalFrame[] getAllFrames()

返回桌面中当前显示的所有 JInternalFrames。返回图标化的窗体和扩展的窗体。

返回：

JInternalFrame 对象的数组

getSelectedFrame

public JInternalFrame getSelectedFrame()

返回此 JDesktopPane 中当前活动的 JInternalFrame，如果当前没有活动的 JInternalFrame，则返回 null。

返回：

当前活动的 JInternalFrame 或 null

从以下版本开始：

1.3

setSelectedFrame

public void setSelectedFrame(JInternalFrame f)

设置此 JDesktopPane 中当前活动的 JInternalFrame。此方法用于连接JDesktopPane 和平台实现代码，不应该直接调用。要可视化地选择窗体，客户端必须调用 JInternalFrame.setSelected(true) 激活窗体。

参数：

f - 当前选中的内部窗体

从以下版本开始：

1.3

另请参见：

JInternalFrame.setSelected(boolean)

getAllFramesInLayer

public JInternalFrame[] getAllFramesInLayer(int layer)

返回桌面指定层中当前所显示的所有 JInternalFrames。返回图标化的窗体和扩展的窗体。

参数：

layer - 指定桌面层的 int 值

返回：

JInternalFrame 对象的数组

另请参见：

JLayeredPane

selectFrame

public JInternalFrame selectFrame(boolean forward)

选择此桌面窗格中的下一个 JInternalFrame。

参数：

forward - 一个 boolean 值，指示选择的方向；true 表示向前，false 表示向后

返回：

选择的 JInternalFrame；如果未选择任何窗体，则返回 null

从以下版本开始：

1.6

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)

将指定组件添加到此容器的指定索引所在的位置上。此方法还通知布局管理器，通过 addLayoutComponent 方法，使用指定的约束对象将组件添加到此容器的布局中。

这些约束是由正使用的特定布局管理器定义的。例如，BorderLayout 类定义了五个约束：BorderLayout.NORTH、BorderLayout.SOUTH、BorderLayout.EAST、BorderLayout.WEST 和 BorderLayout.CENTER。

GridBagLayout 类需要一个 GridBagConstraints 对象。如果传递正确的约束对象类型时失败，则会导致 IllegalArgumentException。

如果当前布局管理器实现了 LayoutManager2，则在其上调用 LayoutManager2.addLayoutComponent(Component,Object)。如果当前布局管理器没有实现 LayoutManager2，并且约束是一个 String，则在其上调用 LayoutManager.addLayoutComponent(String,Component)。

如果该组件不是此容器的祖先容器，并且有一个非 null 父组件，则在将该组件添加到此容器之前，从其当前父组件中移除它。

在其他所有添加方法引用此方法时，如果某个程序需要追踪每个添加到容器的请求，那么这就是要重写的方法。被重写的方法通常应该包括一个对该方法的超类版本的调用：

super.addImpl(comp, constraints, index)

覆盖：

类 JLayeredPane 中的 addImpl

参数：

comp - 要添加的组件

constraints - 表示此组件的布局约束的对象

从以下版本开始：

1.6

另请参见：

Container.add(Component), Container.add(Component, int), Container.add(Component, java.lang.Object), LayoutManager, LayoutManager2

remove

public void remove(int index)

从此窗格中移除已索引的组件。这是绝对索引，与层无关。

覆盖：

类 JLayeredPane 中的 remove

参数：

index - 指定要移除组件的 int 值

从以下版本开始：

1.6

另请参见：

JLayeredPane.getIndexOf(java.awt.Component)

removeAll

public void removeAll()

从此容器中移除所有组件。

覆盖：

类 JLayeredPane 中的 removeAll

从以下版本开始：

1.6

另请参见：

Container.add(java.awt.Component), Container.remove(int)

setComponentZOrder

public void setComponentZOrder(Component comp,
                               int index)

将指定组件移动到容器中指定的 z 顺序索引。z 顺序确定了绘制组件的顺序；具有最高 z 顺序的组件将第一个绘制，而具有最低 z 顺序的组件将最后一个绘制。在组件重叠的地方，具有较低 z 顺序的组件将覆盖具有较高 z 顺序的组件。

如果组件是其他某个 container 的子组件，则在将它添加到此容器之前，从该容器中移除它。此方法与 java.awt.Container.add(Component, int) 之间的重要不同是，在将组件从其以前的容器中移除时，此方法不对该组件调用 removeNotify，除非有此必要，并且基础本机窗口系统允许这样做。因此，如果组件拥有键盘焦点，那么在移动到新的位置上时，它会维持该焦点。

要保证此属性只应用于轻量级的非 Container 组件。

注：并不是所有的平台都支持在不调用 removeNotify 的情况下，将重量级组件的 z 顺序从一个容器更改到另一个容器中。无法检测某个平台是否支持这一点，因此开发人员不应该作出任何假设。

覆盖：

类 Container 中的 setComponentZOrder

参数：

comp - 要移动的组件

index - 在容器的列表中插入组件的位置，其中 getComponentCount() 指追加到尾部

从以下版本开始：

1.6

另请参见：

Container.getComponentZOrder(java.awt.Component)

paramString

protected String paramString()

返回此 JDesktopPane 的字符串表示形式。此方法仅在进行调试时使用，对于各个实现，所返回字符串的内容和格式可能有所不同。返回的字符串可能为空，但不可能为 null。

覆盖：

类 JLayeredPane 中的 paramString

返回：

此 JDesktopPane 的字符串表示形式

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此 JDesktopPane 关联的 AccessibleContext。对于桌面窗格，AccessibleContext 采用 AccessibleJDesktopPane 的形式。如有必要，可以创建一个新的 AccessibleJDesktopPane 实例。

指定者：

接口 Accessible 中的 getAccessibleContext

覆盖：

类 JLayeredPane 中的 getAccessibleContext

返回：

充当此 JDesktopPane 的 AccessibleContext 的 AccessibleJDesktopPane

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