javax.swing

Класс JDesktopPane

java.lang. Объект

java.awt. Компонент

java.awt. Контейнер

javax.swing. JComponent

javax.swing. JLayeredPane

javax.swing. JDesktopPane

Все Реализованные Интерфейсы:

ImageObserver, MenuContainer, Сериализуемый, Доступный

public class JDesktopPane
extends JLayeredPane
implements Accessible

Контейнер, используемый, чтобы создать многодокументный интерфейс или виртуальный рабочий стол. Вы создаете JInternalFrame объекты и добавляют их к JDesktopPane. JDesktopPane расширяется JLayeredPane управлять потенциально накладывающимися внутренними рамками. Это также поддерживает ссылку на экземпляр DesktopManager это устанавливается UI class для текущего стили (L&F). Отметьте это JDesktopPane не поддерживает границы.

Этот class обычно используется в качестве родителя JInternalFrames обеспечить сменное DesktopManager возразите против JInternalFrames. installUI из L&F определенная реализация ответственна за установку desktopManager переменная соответственно. Когда родитель a JInternalFrame a JDesktopPane, это должно делегировать большую часть своего поведения к desktopManager (закрытие, изменение размеров, и т.д.).

Для дальнейшей документации и примеров видят, Как Использовать Внутренние рамки, раздел в Учебном руководстве по Java.

Предупреждение: Swing не ориентирован на многопотоковое исполнение. Для получения дополнительной информации см., что Swing Распараллеливает Политику.

Предупреждение: Сериализированные объекты этого class не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего ^JavaBeansTM была добавлена к java.beans пакет. Пожалуйста, см. XMLEncoder.

См. Также:

JInternalFrame, JInternalFrame.JDesktopIcon, DesktopManager

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Класс и Описание
protected class	JDesktopPane. AccessibleJDesktopPane Этот class реализует поддержку доступности JDesktopPane class.

Вложенные классы/интерфейсы, наследованные от class javax.swing. JLayeredPane

JLayeredPane. AccessibleJLayeredPane

Вложенные классы/интерфейсы, наследованные от class javax.swing. JComponent

JComponent. AccessibleJComponent

Вложенные классы/интерфейсы, наследованные от class java.awt. Контейнер

Контейнер. AccessibleAWTContainer

Вложенные классы/интерфейсы, наследованные от class java.awt. Компонент

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

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static int	LIVE_DRAG_MODE Указывает, что все содержание перетаскиваемого элемента должно появиться в настольной области.
static int	OUTLINE_DRAG_MODE Указывает, что схема только перетаскиваемого элемента должна появиться в настольной области.

Поля, наследованные от class javax.swing. JLayeredPane

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

Поля, наследованные от class javax.swing. JComponent

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

Поля, наследованные от class java.awt. Компонент

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, наследованные от интерфейса java.awt.image. ImageObserver

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

Сводка конструктора

Конструкторы

Конструктор и Описание
JDesktopPane() Создает новое JDesktopPane.

Сводка метода

Модификатор и Тип	Метод и Описание
protected void	addImpl(Component comp, Object constraints, int index) Добавляет, что указанный компонент к этому контейнеру в указанном индексирует.
AccessibleContext	getAccessibleContext() Добирается AccessibleContext связанный с этим JDesktopPane.
JInternalFrame[]	getAllFrames() Возвраты все JInternalFrames в настоящий момент выведенный на экран в рабочем столе.
JInternalFrame[]	getAllFramesInLayer(int layer) Возвраты все JInternalFrames в настоящий момент выведенный на экран в указанном уровне рабочего стола.
DesktopManager	getDesktopManager() Возвраты DesktopManger это обрабатывает специфичные для рабочего стола действия UI.
int	getDragMode() Получает ток, "перетаскивающий стиль", используемый настольной областью.
JInternalFrame	getSelectedFrame() Возвращает в настоящий момент активное JInternalFrame в этом JDesktopPane, или null если нет JInternalFrame является в настоящий момент активным.
DesktopPaneUI	getUI() Возвращается L&F объект, который представляет этот компонент.
Строка	getUIClassID() Возвращает имя L&F class, который представляет этот компонент.
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) Перемещается указанный компонент к указанному z-порядку индексируют в контейнере.
void	setDesktopManager(DesktopManager d) Наборы DesktopManger это обработает специфичные для рабочего стола действия UI.
void	setDragMode(int dragMode) Устанавливает "стиль перетаскивания", используемый настольной областью.
void	setSelectedFrame(JInternalFrame f) Устанавливает в настоящий момент активное JInternalFrame в этом JDesktopPane.
void	setUI(DesktopPaneUI ui) Устанавливает L&F объект, который представляет этот компонент.
void	updateUI() Уведомление от UIManager то, что L&F изменился.

Методы, наследованные от class javax.swing. JLayeredPane

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

Методы, наследованные от 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

Методы, наследованные от class java.awt. Контейнер

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

Методы, наследованные от class java.awt. Компонент

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

Методы, наследованные от class java.lang. Объект

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 - стиль перетаскивает, чтобы использовать для элементов в Рабочем столе

С тех пор:

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()

Возвраты DesktopManger это обрабатывает специфичные для рабочего стола действия UI.

setDesktopManager

public void setDesktopManager(DesktopManager d)

Наборы DesktopManger это обработает специфичные для рабочего стола действия UI. Это может быть переопределено LookAndFeel.

Параметры:

d - DesktopManager использовать

updateUI

public void updateUI()

Уведомление от UIManager то, что L&F изменился. Заменяет текущий объект UI последней версией от UIManager.

Переопределения:

updateUI в class JComponent

См. Также:

JComponent.updateUI()

getUIClassID

public String getUIClassID()

Возвращает имя L&F class, который представляет этот компонент.

Переопределения:

getUIClassID в class 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 (истина), чтобы активировать фрейм.

Параметры:

f - внутренняя рамка это в настоящий момент выбирается

С тех пор:

1.3

См. Также:

JInternalFrame.setSelected(boolean)

getAllFramesInLayer

public JInternalFrame[] getAllFramesInLayer(int layer)

Возвраты все JInternalFrames в настоящий момент выведенный на экран в указанном уровне рабочего стола. Возвраты представленные в виде значка фреймы также расширенные фреймы.

Параметры:

layer - интервал, определяющий настольный уровень

Возвраты:

массив JInternalFrame объекты

См. Также:

JLayeredPane

удалить

public void remove(Component comp)

Удаляет указанный компонент из этого контейнера. Этот метод также уведомляет менеджера по расположению, чтобы удалить компонент из расположения этого контейнера через removeLayoutComponent метод.

Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов. Если контейнер был уже выведен на экран, иерархия должна быть проверена после того, чтобы отразить изменения.

Переопределения:

remove в class 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 class определяет пять ограничений: BorderLayout.NORTH, BorderLayout.SOUTH, BorderLayout.EAST, BorderLayout.WEST, и BorderLayout.CENTER.

GridBagLayout class требует a GridBagConstraints объект. Отказ передать корректный тип ограничений возражает результатам в IllegalArgumentException.

Если текущий менеджер по расположению реализует LayoutManager2, тогда LayoutManager2.addLayoutComponent(Component,Object) вызывается на это. Если текущий менеджер по расположению не реализует LayoutManager2, и ограничения являются a String, тогда LayoutManager.addLayoutComponent(String,Component) вызывается на это.

Если компонент не является предком этого контейнера и имеет ненулевого родителя, это удаляется из его текущего родителя прежде, чем это будет добавлено к этому контейнеру.

Это - метод, чтобы переопределить, если программа должна отследить каждый добавляла запрос к контейнеру как все другой добавляла, что методы подчиняются этому. Метод переопределения должен обычно включать звонок в версию суперкласса метода:

super.addImpl(comp, constraints, index)

Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов. Если контейнер был уже выведен на экран, иерархия должна быть проверена после того, чтобы вывести на экран добавленный компонент.

Переопределения:

addImpl в class JLayeredPane

Параметры:

comp - компонент, который будет добавлен

constraints - объект, выражающий ограничения расположения для этого компонента

index - позиция в списке контейнера, в котором можно вставить компонент, где -1 средства добавляют до конца

С тех пор:

1.6

См. Также:

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

удалить

public void remove(int index)

Удалите индексированный компонент из этой области. Это - абсолют, индексируют, игнорируя уровни.

Переопределения:

remove в class JLayeredPane

Параметры:

index - интервал, определяющий компонент, чтобы удалить

С тех пор:

1.6

См. Также:

JLayeredPane.getIndexOf(java.awt.Component)

removeAll

public void removeAll()

Удаляет все компоненты из этого контейнера.

Переопределения:

removeAll в class 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) тот этот метод, не вызывает removeNotify на компоненте, удаляя это из его предыдущего контейнера, если необходимый и когда позволено базовой собственной системой управления окнами. Таким образом, если у компонента есть клавиатурный фокус, он уделяет внимание когда перемещено в новую позицию.

Это свойство, как гарантируют, будет применяться только легкому весу не -Container компоненты.

Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов.

Отметьте: Не вся поддержка платформ, изменяющая z-порядок тяжелых компонентов от одного контейнера в другого без звонка removeNotify. Нет никакого способа обнаружить, поддерживает ли платформа это, таким образом, разработчики не должны сделать предположения.

Переопределения:

setComponentZOrder в class Container

Параметры:

comp - компонент, который будет перемещен

index - позиция в списке контейнера, чтобы вставить компонент, где getComponentCount() добавляет до конца

С тех пор:

1.6

См. Также:

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

paramString

protected String paramString()

Возвращает строковое представление этого JDesktopPane. Этот метод предназначается, чтобы использоваться только для того, чтобы отладить цели, и контент и формат возвращенной строки могут измениться между реализациями. Возвращенная строка может быть пустой, но, возможно, не null.

Переопределения:

paramString в class JLayeredPane

Возвраты:

строковое представление этого JDesktopPane

getAccessibleContext

public AccessibleContext getAccessibleContext()

Добирается AccessibleContext связанный с этим JDesktopPane. Для настольных областей, AccessibleContext принимает форму AccessibleJDesktopPane. Новое AccessibleJDesktopPane экземпляр создается в случае необходимости.

Определенный:

getAccessibleContext в интерфейсе Accessible

Переопределения:

getAccessibleContext в class JLayeredPane

Возвраты:

AccessibleJDesktopPane это служит AccessibleContext из этого JDesktopPane