javax.swing

Class JDesktopPane

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JLayeredPane

javax.swing.JDesktopPane

All Implemented Interfaces:

ImageObserver ， MenuContainer ， Serializable ， Accessible

public class JDesktopPane
extends JLayeredPane
implements Accessible

用于创建多文档界面或虚拟桌面的容器。 您创建JInternalFrame对象并将其添加到JDesktopPane 。 JDesktopPane扩展了JLayeredPane以管理可能重叠的内部帧。 它还保留了由UI类设置的当前外观（L＆F）的DesktopManager实例的DesktopManager 。 请注意， JDesktopPane不支持边框。

这个类通常被用作父JInternalFrames是提供一种可插入DesktopManager对象到JInternalFrames 。 所述installUI的L＆F具体实现的是负责设置desktopManager适当地可变。 当JInternalFrame的父母是JDesktopPane时，它应该将其大部分行为委托给desktopManager （关闭，调整大小等）。

有关进一步的文档和示例，请参阅How to Use Internal Frames “Java教程 ”中的一节。

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

警告：此类的序列化对象与将来的Swing版本不兼容。 当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。 从1.4开始，对所有JavaBeans的长期存储的支持已经添加到java.beans包中。 请参阅XMLEncoder 。

另请参见：

JInternalFrame ， JInternalFrame.JDesktopIcon ， DesktopManager

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	JDesktopPane.AccessibleJDesktopPane 这个类实现了可访问性支持 JDesktopPane类。

Nested classes/interfaces inherited from class javax.swing.JLayeredPane

JLayeredPane.AccessibleJLayeredPane

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
static int	LIVE_DRAG_MODE 表示正在拖动的项目的全部内容应显示在桌面窗格中。
static int	OUTLINE_DRAG_MODE 表示只有正在拖动的项目的轮廓应该出现在桌面窗格中。

Fields inherited from class javax.swing.JLayeredPane

DEFAULT_LAYER, DRAG_LAYER, FRAME_CONTENT_LAYER, LAYER_PROPERTY, MODAL_LAYER, PALETTE_LAYER, POPUP_LAYER

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

构造方法

Constructor and Description
JDesktopPane() 创建一个新的 JDesktopPane 。

方法摘要

Modifier and Type	Method and Description
protected void	addImpl(Component comp, Object constraints, int index) 在指定的索引处将指定的组件添加到此容器。
AccessibleContext	getAccessibleContext() 获取 AccessibleContext与此相关 JDesktopPane 。
JInternalFrame[]	getAllFrames() 返回目前在桌面上显示的所有 JInternalFrames 。
JInternalFrame[]	getAllFramesInLayer(int layer) 返回当前显示在桌面的指定层中的所有 JInternalFrames 。
DesktopManager	getDesktopManager() 返回处理桌面特定UI操作的 DesktopManger 。
int	getDragMode() 获取桌面窗格使用的当前“拖动样式”。
JInternalFrame	getSelectedFrame() 返回当前活动 JInternalFrame这个 JDesktopPane ，或 null如果没有 JInternalFrame当前处于活动状态。
DesktopPaneUI	getUI() 返回渲染此组件的L＆F对象。
String	getUIClassID() 返回呈现此组件的L＆F类的名称。
protected String	paramString() 返回此 JDesktopPane的字符串表示 JDesktopPane 。
void	remove(Component comp) 从此容器中删除指定的组件。
void	remove(int index) 从此窗格中删除索引的组件。
void	removeAll() 从此容器中删除所有组件。
JInternalFrame	selectFrame(boolean forward) 选择此桌面窗格中的下一个 JInternalFrame 。
void	setComponentZOrder(Component comp, int index) 将指定的组件移动到容器中指定的z顺序索引。
void	setDesktopManager(DesktopManager d) 设置将处理桌面特定UI操作的 DesktopManger 。
void	setDragMode(int dragMode) 设置桌面窗格使用的“拖动样式”。
void	setSelectedFrame(JInternalFrame f) 设置当前激活的 JInternalFrame在这 JDesktopPane 。
void	setUI(DesktopPaneUI ui) 设置渲染此组件的L＆F对象。
void	updateUI() 通知从 UIManager ，L＆F已经改变了。

Methods inherited from class javax.swing.JLayeredPane

getComponentCountInLayer, getComponentsInLayer, getComponentToLayer, getIndexOf, getLayer, getLayer, getLayeredPaneAbove, getObjectForLayer, getPosition, highestLayer, insertIndexForLayer, isOptimizedDrawingEnabled, lowestLayer, moveToBack, moveToFront, paint, putLayer, setLayer, setLayer, setPosition

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, removeContainerListener, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细信息

LIVE_DRAG_MODE

public static final int LIVE_DRAG_MODE

表示正在拖动的项目的全部内容应显示在桌面窗格中。

另请参见：

OUTLINE_DRAG_MODE ， setDragMode(int) ， Constant Field Values

OUTLINE_DRAG_MODE

public static final int OUTLINE_DRAG_MODE

表示只有正在拖动的项目的轮廓应该出现在桌面窗格中。

另请参见：

LIVE_DRAG_MODE ， setDragMode(int) ， Constant Field Values

构造方法详细信息

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 - 用于桌面中项目的拖动样式

从以下版本开始：

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 。 这可能被LookAndFeel所LookAndFeel 。

参数

d - DesktopManager使用

updateUI

public void updateUI()

通知从UIManager ，L＆F已经改变。 从UIManager替换最新版本的当前UI对象。

重写：

updateUI在 JComponent

另请参见：

JComponent.updateUI()

getUIClassID

public String getUIClassID()

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

重写：

getUIClassID在 JComponent

结果

字符串“DesktopPaneUI”

另请参见：

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

getAllFrames

public JInternalFrame[] getAllFrames()

返回目前在桌面上显示的所有JInternalFrames 。 返回图标化框架和展开框架。

结果

一组 JInternalFrame对象

getSelectedFrame

public JInternalFrame getSelectedFrame()

返回当前活动 JInternalFrame这个 JDesktopPane ，或 null如果没有 JInternalFrame当前处于活动状态。

结果

目前活跃的 JInternalFrame或 null

从以下版本开始：

1.3

setSelectedFrame

public void setSelectedFrame(JInternalFrame f)

设置当前激活的JInternalFrame在这JDesktopPane 。 该方法用于桥接JDesktopPane和平台实现代码之间的包间隙，不应直接调用。 为了可视化地选择客户机必须调用JInternalFrame.setSelected（true）来激活帧的帧。

参数

f - 当前选中的内部框架

从以下版本开始：

1.3

另请参见：

JInternalFrame.setSelected(boolean)

getAllFramesInLayer

public JInternalFrame[] getAllFramesInLayer(int layer)

返回当前显示在桌面的指定图层中的所有JInternalFrames 。 返回图标化帧以及扩展帧。

参数

layer - 指定桌面层的int

结果

一组 JInternalFrame对象

另请参见：

JLayeredPane

remove

public void remove(Component comp)

从此容器中删除指定的组件。 此方法还会通过布局管理器通过removeLayoutComponent方法从该容器的布局中removeLayoutComponent 。

该方法更改布局相关信息，因此使组件层次结构无效。 如果已经显示了容器，则此后必须验证层次结构以反映更改。

重写：

remove在 Container

参数

comp - 要移除的组件

另请参见：

Container.add(java.awt.Component) ， Container.invalidate() ， Container.validate() ， Container.remove(int)

selectFrame

public JInternalFrame selectFrame(boolean forward)

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

参数

forward - 一个布尔值，表示选择哪个方向; 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)就被调用了。

如果组件不是此容器的祖先，并且具有非空父项，则在将其添加到此容器之前，它将从其当前父进程中删除。

如果程序需要跟踪每个添加到容器的请求，那么这种方法将会覆盖所有其他添加方法。 一个重写方法通常应该包括调用超类的方法版本：

super.addImpl(comp, constraints, index)

该方法更改布局相关信息，因此使组件层次结构无效。 如果容器已经被显示，则此后必须验证层次结构，以显示添加的组件。

重写：

addImpl在 JLayeredPane

参数

comp - 要添加的组件

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

index - 容器列表中插入组件的位置，其中 -1表示附加到最后

从以下版本开始：

1.6

另请参见：

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

remove

public void remove(int index)

从此窗格中删除索引的组件。 这是绝对的索引，忽略了层。

重写：

remove在 JLayeredPane

参数

index - 一个int指定要删除的组件

从以下版本开始：

1.6

另请参见：

JLayeredPane.getIndexOf(java.awt.Component)

removeAll

public void removeAll()

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

重写：

removeAll在 JLayeredPane

从以下版本开始：

1.6

另请参见：

Container.add(java.awt.Component) ， Container.remove(int) ， Container.invalidate()

setComponentZOrder

public void setComponentZOrder(Component comp,
                               int index)

将指定的组件移动到容器中指定的z顺序索引。 z次序确定组件被绘制的顺序; 首先使用最高z阶涂料的组分，最后使用最低z阶涂料的组分。 在组件重叠的地方，具有较低z阶的组件涂覆在具有较高z阶的组件上。

如果组件是某个其他容器的子对象，则在添加到此容器之前将其从该容器中删除。 此方法与java.awt.Container.add(Component, int)之间的java.awt.Container.add(Component, int)在于，该方法不会在removeNotify上调用removeNotify ，而是从其先前的容器中删除它，除非有必要，并且在底层本机窗口系统允许的情况下。 这样，如果组件具有键盘焦点，则在移动到新位置时会保持焦点。

此属性保证仅适用于轻型非Container组件。

该方法更改布局相关信息，因此使组件层次结构无效。

注意 ：并非所有平台都支持将重量级组件的z顺序从一个容器更改为另一个，而无需调用removeNotify 。 无法检测平台是否支持此功能，因此开发人员不应作出任何假设。

重写：

setComponentZOrder在 Container

参数

comp - 要移动的组件

index - 容器列表中插入组件的位置，其中 getComponentCount()附加到最后

从以下版本开始：

1.6

另请参见：

Container.getComponentZOrder(java.awt.Component) ， Container.invalidate()

paramString

protected String paramString()

返回此JDesktopPane的字符串表示JDesktopPane 。 该方法仅用于调试目的，并且返回的字符串的内容和格式可能因实现而异。 返回的字符串可能为空，但可能不是null 。

重写：

paramString在 JLayeredPane

结果

这个 JDesktopPane的字符串表示 JDesktopPane

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取AccessibleContext与此相关JDesktopPane 。 对于桌面窗格中， AccessibleContext需要一个形式AccessibleJDesktopPane 。 如果需要，将创建一个新的AccessibleJDesktopPane实例。

Specified by:

getAccessibleContext在接口 Accessible

重写：

getAccessibleContext在 JLayeredPane

结果

一个 AccessibleJDesktopPane ，作为这个 AccessibleContext的 JDesktopPane