JDesktopPane (Java Platform SE 8 )

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

Class JDesktopPane

Nested Class Summary

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

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

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

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

Field Summary

Fields inherited from class javax.swing.JLayeredPane

Fields inherited from class javax.swing.JComponent

Fields inherited from class java.awt.Component

Fields inherited from interface java.awt.image.ImageObserver

构造方法摘要

方法摘要

Methods inherited from class javax.swing.JLayeredPane

Methods inherited from class javax.swing.JComponent

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

字段详细信息

LIVE_DRAG_MODE

OUTLINE_DRAG_MODE

构造方法详细信息

JDesktopPane

方法详细信息

getUI

setUI

setDragMode

getDragMode

getDesktopManager

setDesktopManager

updateUI

getUIClassID

getAllFrames

getSelectedFrame

setSelectedFrame

getAllFramesInLayer

remove

selectFrame

addImpl

remove

removeAll

setComponentZOrder

paramString

getAccessibleContext