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 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

另请参见：

JInternalFrame, JInternalFrame.JDesktopIcon, DesktopManager

嵌套类摘要

protected class

JDesktopPane.AccessibleJDesktopPane 此类实现对 JDesktopPane 类的可访问性支持。

从类 javax.swing.JLayeredPane 继承的嵌套类/接口

JLayeredPane.AccessibleJLayeredPane

从类 javax.swing.JComponent 继承的嵌套类/接口

JComponent.AccessibleJComponent

从类 java.awt.Container 继承的嵌套类/接口

Container.AccessibleAWTContainer

从类 java.awt.Component 继承的嵌套类/接口

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

字段摘要

static int	LIVE_DRAG_MODE 指示正在被拖动项的所有内容是否应该出现在桌面窗格内部。
static int	OUTLINE_DRAG_MODE 指示桌面窗格是否只应该出现正在被拖动项的轮廓。

从类 javax.swing.JLayeredPane 继承的字段

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

从类 javax.swing.JComponent 继承的字段

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

从类 java.awt.Component 继承的字段

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

从接口 java.awt.image.ImageObserver 继承的字段

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

构造方法摘要

JDesktopPane()
创建一个新的 JDesktopPane。

方法摘要

AccessibleContext	getAccessibleContext() 获取与此 JDesktopPane 关联的 AccessibleContext。
JInternalFrame[]	getAllFrames() 返回桌面中当前显示的所有 JInternalFrames。
JInternalFrame[]	getAllFramesInLayer(int layer) 返回桌面指定层中当前所显示的所有 JInternalFrames。
DesktopManager	getDesktopManager() 返回处理特定于桌面 UI 操作的 DesktopManger。
int	getDragMode() 获取桌面窗格当前使用的“拖动样式”。
JInternalFrame	getSelectedFrame() 返回此 JDesktopPane 中当前活动的 JInternalFrame，如果当前没有活动的 JInternalFrame，则返回 null。
DesktopPaneUI	getUI() 返回呈现此组件的 L&F 对象。
String	getUIClassID() 返回呈现此组件的 L&F 类名。
boolean	isOpaque() 返回 true 指示此组件绘制其范围内的所有像素。
protected String	paramString() 返回此 JDesktopPane 的字符串表示形式。
void	setDesktopManager(DesktopManager d) 设置处理特定于桌面 UI 操作的 DesktopManger。
void	setDragMode(int dragMode) 设置桌面窗格使用的“拖动样式”。
void	setSelectedFrame(JInternalFrame f) 设置此 JDesktopPane 中当前活动的 JInternalFrame。
void	setUI(DesktopPaneUI ui) 设置呈现此组件的 L&F 对象。
void	updateUI() UIManager 发出的关于 L&F 已改变的通知。

从类 javax.swing.JLayeredPane 继承的方法

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

从类 javax.swing.JComponent 继承的方法

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, 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, isDoubleBuffered, isLightweightComponent, isManagingFocus, 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

从类 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, remove, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree

从类 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, hide, 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, transferFocusUpCycle

从类 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), 常量字段值

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 中各项所用的拖动样式

另请参见：

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)

设置处理特定于桌面 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。

参数：

f - 当前选中的内部窗体

从以下版本开始：

1.3

getAllFramesInLayer

public JInternalFrame[] getAllFramesInLayer(int layer)

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

参数：

layer - 指定桌面层的 int 值

返回：

JInternalFrame 对象的数组

另请参见：

JLayeredPane

isOpaque

public boolean isOpaque()

返回 true 指示此组件绘制其范围内的所有像素。（换句话说，此组件没有透明的背景或前景。）

覆盖：

类 JComponent 中的 isOpaque

返回：

true

另请参见：

JComponent.isOpaque()

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