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管理可能重叠的内部框架。它还维护一个参照 DesktopManager是由UI类的外观和感觉的一个实例（L和F）。注意， JDesktopPane不支持边界。

这类通常是作为JInternalFrames家长的JInternalFrames提供一个可插拔的DesktopManager对象。该公司具体负责实施的设置desktopManager变量的installUI。当一个JInternalFrame父母是一个JDesktopPane，它应该代表了大多数行为的desktopManager（收盘，大小，等等）。

进一步的文档和示例见How to Use Internal Frames，java教程中的一部分。

警告： Swing是线程不安全的。更多信息见Swing's Threading Policy。

警告：序列化该类的对象与以后的Swing版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为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() 在这 JDesktopPane返回当前活动的 JInternalFrame，或 null如果没有 JInternalFrame当前是活动的。
DesktopPaneUI	getUI() 返回呈现此组件的L和F对象。
String	getUIClassID() 返回呈现此组件的“L”和“F”类的名称。
protected String	paramString() 返回该 JDesktopPane字符串表示形式。
void	remove(Component comp) 从该容器中移除指定的组件。
void	remove(int index) 从该窗格中删除索引组件。
void	removeAll() 从这个容器中移除所有的组件。
JInternalFrame	selectFrame(boolean forward) 选择在这一 JInternalFrame桌面窗格。
void	setComponentZOrder(Component comp, int index) 将指定的组件在容器中的指定顺序索引。
void	setDesktopManager(DesktopManager d) 集 DesktopManger将处理特定的UI操作桌面。
void	setDragMode(int dragMode) 设置桌面窗格中使用的“拖动样式”。
void	setSelectedFrame(JInternalFrame f) 在这 JDesktopPane目前活跃的 JInternalFrame集。
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

Field Detail

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

Constructor Detail

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 -拖动使用在桌面项目的风格

从以下版本开始：

一点三

另请参见：

LIVE_DRAG_MODE， OUTLINE_DRAG_MODE

getDragMode

public int getDragMode()

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

结果

无论是 Live_DRAG_MODE或 OUTLINE_DRAG_MODE

从以下版本开始：

一点三

另请参见：

setDragMode(int)

getDesktopManager

public DesktopManager getDesktopManager()

返回桌面UI处理具体行动的 DesktopManger。

setDesktopManager

public void setDesktopManager(DesktopManager d)

集 DesktopManger将处理特定的UI操作桌面。这也许会被 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()

在这 JDesktopPane返回当前活动的 JInternalFrame，或 null如果没有 JInternalFrame当前是活动的。

结果

目前活跃的 JInternalFrame或 null

从以下版本开始：

一点三

setSelectedFrame

public void setSelectedFrame(JInternalFrame f)

在这 JDesktopPane目前活跃的 JInternalFrame集。此方法用于桥梁JDesktopPane及其平台实现代码之间的包差距不应该直接调用。视觉选择框架的客户端必须调用jinternalframe。设置选择（真正的）激活框架。

参数

f -内部框架的当前选择

从以下版本开始：

一点三

另请参见：

JInternalFrame.setSelected(boolean)

getAllFramesInLayer

public JInternalFrame[] getAllFramesInLayer(int layer)

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

参数

layer指定桌面层int

结果

对 JInternalFrame对象数组

另请参见：

JLayeredPane

remove

public void remove(Component comp)

从该容器中移除指定的组件。这种方法也将布局管理器删除组件容器的布局方法，通过 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如果选择了什么

从以下版本开始：

一点六

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意味着追加到最后

从以下版本开始：

一点六

另请参见：

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

从以下版本开始：

一点六

另请参见：

JLayeredPane.getIndexOf(java.awt.Component)

removeAll

public void removeAll()

从这个容器中移除所有的组件。

重写：

removeAll 方法重写，继承类 JLayeredPane

从以下版本开始：

一点六

另请参见：

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

setComponentZOrder

public void setComponentZOrder(Component comp,
                               int index)

将指定的组件在容器中的指定顺序索引。顺序决定了组件的顺序画；组件的最高与最低的第一顺序涂料组成涂料的最后次序。其中部分重叠，与较低的顺序画在高Z元件的元件。

如果该组件是一些其他容器的子容器，则在将该组件添加到该容器之前，将其从该容器中删除。这种方法和java.awt.Container.add(Component, int)之间的重要区别是，该方法不叫removeNotify组件上的同时消除它从以前的容器，除非必要时，允许由底层的本地窗口系统。这样，如果组件具有键盘焦点，当移动到新位置时，它保持焦点。

此属性是保证仅适用于轻non-Container组件。

这种方法改变布局的相关信息，因此，无效的组件层次结构。

注：并不是所有的平台都支持改变重量级组件顺序从一个容器到另一个没有打电话removeNotify。有没有办法检测到一个平台是否支持这一点，所以开发人员不应该作出任何假设。

重写：

setComponentZOrder 方法重写，继承类 Container

参数

comp -可移动组件

index在容器的列表的位置插入成分，其中 getComponentCount()追加到最后

从以下版本开始：

一点六

另请参见：

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

paramString

protected String paramString()

返回该 JDesktopPane字符串表示形式。此方法仅用于调试目的，返回的字符串的内容和格式可能会在实现过程中有所不同。返回的字符串是空的但可能不 null。

重写：

paramString 方法重写，继承类 JLayeredPane

结果

这 JDesktopPane字符串表示形式

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此相关的 AccessibleContext JDesktopPane。桌面窗格，该 AccessibleContext以一个 AccessibleJDesktopPane形式。一个新的 AccessibleJDesktopPane实例被创建时。

Specified by:

getAccessibleContext 接口 Accessible

重写：

getAccessibleContext 方法重写，继承类 JLayeredPane

结果

一个 AccessibleJDesktopPane作为本 JDesktopPane的 AccessibleContext