Класс JRootPane

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.JRootPane

Все реализованные интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible

public class JRootPane
extends JComponent
implements Accessible

Легковесный контейнер, используемый в фоновом режиме JFrame, JDialog, JWindow, JApplet, и JInternalFrame. Для получения информации о функциональности, предоставляемой панелями корня, см. Как использовать панели корня, раздел в Учебнике Java.

На следующем изображении показаны отношения между классами, использующими панели корня.

The following text describes this graphic.

Компоненты «тяжелого веса» (те, которые делегируют работе peer, или нативному компоненту на хост-системе) показаны более тёмным, более толстым прямоугольником. Четыре контейнера JFC/Swing тяжелого веса (JFrame, JDialog, JWindow, и JApplet) показаны по отношению к классам AWT, которые они расширяют. Эти четыре компонента являются единственными контейнерами тяжелого веса в библиотеке Swing. Легковесный контейнер JInternalFrame также показан. Все пять этих контейнеров JFC/Swing реализуют интерфейс RootPaneContainer, и все они делегируют свои операции JRootPane (показан маленькой «ручкой» сверху).

Note: The JComponent method getRootPane can be used to obtain the JRootPane that contains a given component.

The following text describes this graphic.

Диаграмма справа показывает структуру JRootPane. JRootpane состоит из glassPane, необязательного menuBar, и contentPane. (JLayeredPane управляет menuBar и contentPane.) glassPane располагается поверх всего, где она находится в позиции для перехвата движений мыши. Поскольку glassPane (как и contentPane) может быть произвольным компонентом, также можно настроить glassPane для рисования. Линии и изображения на glassPane могут тогда охватывать фреймы снизу без ограничений их границами.

Хотя компонент menuBar является необязательным, layeredPane, contentPane, и glassPane всегда существуют. Попытка установить их в значение null приводит к исключению.

Для добавления компонентов в JRootPane (кроме необязательной панели меню), добавьте объект в contentPane JRootPane, как показано ниже:

rootPane.getContentPane().add(child);

Такой же принцип применяется для установки менеджеров компоновки, удаления компонентов, перечисления дочерних элементов и т.д. Все эти методы вызываются на contentPane вместо JRootPane.

Note: The default layout manager for the contentPane is a BorderLayout manager. However, the JRootPane uses a custom LayoutManager. So, when you want to change the layout manager for the components you added to a JRootPane, be sure to use code like this:
    rootPane.getContentPane().setLayout(new BoxLayout());

Если компонент JMenuBar установлен на JRootPane, он размещается вдоль верхней грани фрейма. contentPane изменяет своё расположение и размер, заполняя оставшуюся область. (JMenuBar и contentPane добавляются в компонент layeredPane на уровне JLayeredPane.FRAME_CONTENT_LAYER.)

layeredPane является родителем всех дочерних элементов в JRootPane — как непосредственного родителя меню, так и прародителя всех компонентов, добавленных в contentPane. Он является экземпляром JLayeredPane, что предоставляет возможность добавления компонентов на нескольких уровнях. Эта возможность очень полезна при работе с всплывающими меню, диалоговыми окнами и перетаскиванием — ситуациях, в которых вам нужно расположить компонент поверх всех остальных компонентов в панели.

glassPane располагается поверх всех остальных компонентов в JRootPane. Это удобное место для рисования над всеми другими компонентами, а также позволяет перехватывать события мыши, что полезно как при перетаскивании, так и при рисовании. Разработчики могут использовать setVisible на glassPane для управления отображением glassPane над другими дочерними элементами. По умолчанию glassPane не отображается.

Пользовательский LayoutManager используемый JRootPane гарантирует, что:

glassPane заполняет всю отображаемую область JRootPane (границы - отступы).
layeredPane заполняет всю отображаемую область JRootPane. (границы - отступы)
menuBar размещается на верхней грани layeredPane.
contentPane заполняет всю отображаемую область за вычетом menuBar, если оно присутствует.

Любые другие представления в иерархии просмотра JRootPane игнорируются.

Если вы замените LayoutManager JRootPane, вы несете ответственность за управление всеми этими представлениями. Поэтому обычно вы захотите убедиться, что вы изменяете менеджер компоновки для contentPane а не для JRootPane самого по себе!

Архитектура рисования Swing требует наличия непрозрачного JComponent в иерархии контейнирования над всеми другими компонентами. Обычно это обеспечивается с помощью панели содержимого. Если вы замените панель содержимого, рекомендуется сделать её непрозрачной с помощью setOpaque(true). Кроме того, если панель содержимого переопределяет paintComponent, ей необходимо будет полностью заполнить фон непрозрачным цветом в paintComponent.

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

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

См. также:: JLayeredPane, JMenuBar, JWindow, JFrame, JDialog, JApplet, JInternalFrame, JComponent, BoxLayout, Смешивание компонентов тяжелого и легкого веса

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

Модификатор и тип	Класс и описание
`protected class`	`JRootPane.AccessibleJRootPane` Этот класс реализует поддержку доступности для класса `JRootPane`.
`protected class`	`JRootPane.RootLayout` Пользовательский менеджер компоновки, ответственный за компоновку layeredPane, glassPane и menuBar.

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

Поля

Модификатор и тип	Поле и описание
`static int`	`COLOR_CHOOSER_DIALOG` Константа, используемая для свойства windowDecorationStyle.
`protected Container`	`contentPane` Панель содержимого.
`protected JButton`	`defaultButton` Кнопка, которая активируется, когда у панели есть фокус, и происходит специфичное для пользовательского интерфейса действие, например, нажатие клавиши Enter.
`protected javax.swing.JRootPane.DefaultAction`	`defaultPressAction` Устарело. Начиная с платформы Java 2 v1.3.
`protected javax.swing.JRootPane.DefaultAction`	`defaultReleaseAction` Устарело. Начиная с платформы Java 2 v1.3.
`static int`	`ERROR_DIALOG` Константа, используемая для свойства windowDecorationStyle.
`static int`	`FILE_CHOOSER_DIALOG` Константа, используемая для свойства windowDecorationStyle.
`static int`	`FRAME` Константа, используемая для свойства windowDecorationStyle.
`protected Component`	`glassPane` Панель стекла, которая накладывается на панель меню и панель содержимого, поэтому она может перехватывать движения мыши и т. п.
`static int`	`INFORMATION_DIALOG` Константа, используемая для свойства windowDecorationStyle.
`protected JLayeredPane`	`layeredPane` Панель слоёв, которая управляет панелью меню и панелью содержимого.
`protected JMenuBar`	`menuBar` Панель меню.
`static int`	`NONE` Константа, используемая для свойства windowDecorationStyle.
`static int`	`PLAIN_DIALOG` Константа, используемая для свойства windowDecorationStyle.
`static int`	`QUESTION_DIALOG` Константа, используемая для свойства windowDecorationStyle.
`static int`	`WARNING_DIALOG` Константа, используемая для свойства windowDecorationStyle.

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

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

Поля, унаследованные от класса java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

Конструктор и описание
`JRootPane()` Создаёт `JRootPane`, настраивая его `glassPane`, `layeredPane`, и `contentPane`.

Методы

Модификатор и тип	Метод и описание
`protected void`	`addImpl(Component comp, Object constraints, int index)` Переопределён для принудительного задания положения компонента glass в качестве нулевого потомка.
`void`	`addNotify()` Уведомляет этот компонент о том, что у него теперь есть родительский компонент.
`protected Container`	`createContentPane()` Вызывается методами конструкторов для создания значения по умолчанию `contentPane`.
`protected Component`	`createGlassPane()` Вызывается методами конструкторов для создания значения по умолчанию `glassPane`.
`protected JLayeredPane`	`createLayeredPane()` Вызывается методами конструкторов для создания значения по умолчанию `layeredPane`.
`protected LayoutManager`	`createRootLayout()` Вызывается методами конструкторов для создания значения по умолчанию `layoutManager`.
`AccessibleContext`	`getAccessibleContext()` Возвращает `AccessibleContext` , связанное с этим `JRootPane`.
`Container`	`getContentPane()` Возвращает область содержимого — контейнер, содержащий компоненты, родительские по отношению к корневой области.
`JButton`	`getDefaultButton()` Возвращает значение свойства `defaultButton`.
`Component`	`getGlassPane()` Возвращает текущую область glass для этого `JRootPane`.
`JMenuBar`	`getJMenuBar()` Возвращает строку меню из многослойной области.
`JLayeredPane`	`getLayeredPane()` Получает многослойную область, используемую корневой областью.
`JMenuBar`	`getMenuBar()` Устарело. С версии Swing 1.0.3 заменено на `getJMenuBar()`.
`RootPaneUI`	`getUI()` Возвращает объект L&F, который отображает этот компонент.
`String`	`getUIClassID()` Возвращает строку, которая определяет имя класса L&F, отображающего этот компонент.
`int`	`getWindowDecorationStyle()` Возвращает константу, определяющую тип декораций окна, предоставляемых `JRootPane`.
`boolean`	`isOptimizedDrawingEnabled()` Области `glassPane` и `contentPane` имеют одинаковые границы, что означает `JRootPane` не использует метод tiling для своих дочерних элементов, и поэтому должно возвращать false.
`boolean`	`isValidateRoot()` Если потомок этого `JRootPane` вызывает `revalidate`, валидировать начиная с этого элемента вниз.
`protected String`	`paramString()` Возвращает строковое представление этого `JRootPane`.
`void`	`removeNotify()` Уведомляет этот компонент о том, что у него больше нет родительского компонента.
`void`	`setContentPane(Container content)` Устанавливает область содержимого — контейнер, содержащий компоненты, родительские по отношению к корневой области.
`void`	`setDefaultButton(JButton defaultButton)` Устанавливает свойство `defaultButton`, определяющее текущую кнопку по умолчанию для этого `JRootPane`.
`void`	`setDoubleBuffered(boolean aFlag)` Устанавливает, использовать ли этому компоненту буфер для рисования.
`void`	`setGlassPane(Component glass)` Устанавливает указанную `Component` в качестве области glass для этой корневой области.
`void`	`setJMenuBar(JMenuBar menu)` Добавляет или изменяет строку меню, используемую в многослойной области.
`void`	`setLayeredPane(JLayeredPane layered)` Устанавливает многослойную область для корневой области.
`void`	`setMenuBar(JMenuBar menu)` Устарело. С версии Swing 1.0.3 заменено на `setJMenuBar(JMenuBar menu)`.
`void`	`setUI(RootPaneUI ui)` Устанавливает объект L&F, который отображает этот компонент.
`void`	`setWindowDecorationStyle(int windowDecorationStyle)` Устанавливает тип декораций окна (таких как рамки, виджеты для закрытия окна, заголовок…) , которые `JRootPane` должны предоставлять.
`void`	`updateUI()` Сбрасывает свойство UI на значение из текущего стиля отображения.

Методы, унаследованные от класса javax.swing.JComponent

addAncestorListener, 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, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, 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, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, 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, 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

Методы, унаследованные от класса java.lang.Object

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

Поля

NONE

public static final int NONE

Константа, используемая для свойства windowDecorationStyle. Указывает, что JRootPane не должен предоставлять декораций окна.

Since:: 1.4
См. также:: Значения константных полей

FRAME

public static final int FRAME

Константа, используемая для свойства windowDecorationStyle. Указывает, что JRootPane должен предоставлять декорации, соответствующие окну типа Frame.

Since:: 1.4
См. также:: Значения константных полей

PLAIN_DIALOG

public static final int PLAIN_DIALOG

Константа, используемая для свойства windowDecorationStyle. Указывает, что JRootPane должен предоставлять декорации, соответствующие диалоговому окну.

Since:: 1.4
См. также:: Значения константных полей

INFORMATION_DIALOG

public static final int INFORMATION_DIALOG

Константа, используемая для свойства windowDecorationStyle. Указывает, что JRootPane должен предоставлять декорации, соответствующие диалоговому окну для отображения информационного сообщения.

Since:: 1.4
См. также:: Значения константных полей

ERROR_DIALOG

public static final int ERROR_DIALOG

Since:: 1.4
См. также:: Значения константных полей

COLOR_CHOOSER_DIALOG

public static final int COLOR_CHOOSER_DIALOG

Since:: 1.4
См. также:: Значения константных полей

FILE_CHOOSER_DIALOG

public static final int FILE_CHOOSER_DIALOG

Since:: 1.4
См. также:: Значения константных полей

QUESTION_DIALOG

public static final int QUESTION_DIALOG

Since:: 1.4
См. также:: Значения константных полей

WARNING_DIALOG

public static final int WARNING_DIALOG

Since:: 1.4
См. также:: Значения константных полей

menuBar

protected JMenuBar menuBar

Панель меню.

contentPane

protected Container contentPane

Панель содержимого.

layeredPane

protected JLayeredPane layeredPane

Панель с слоями, управляющая панелью меню и панелью содержимого.

glassPane

protected Component glassPane

Панель стекла, накладываемая на панель меню и панель содержимого, чтобы она могла перехватывать движения мыши и т.п.

defaultButton

protected JButton defaultButton

Кнопка, которая активируется, когда у панели есть фокус, и происходит действие, специфичное для пользовательского интерфейса, например, нажатие клавиши Enter.

defaultPressAction

@Deprecated
protected javax.swing.JRootPane.DefaultAction defaultPressAction

Устарело. Начиная с Java 2 platform v1.3.

Начиная с Java 2 platform v1.3 это неиспользуемое поле больше не используется. Чтобы переопределить кнопку по умолчанию, необходимо заменить Action в JRootPane's ActionMap. Для получения более подробной информации см. спецификацию привязок клавиш.

См. также:: defaultButton

defaultReleaseAction

@Deprecated
protected javax.swing.JRootPane.DefaultAction defaultReleaseAction

Устарело. Начиная с Java 2 platform v1.3.

См. также:: defaultButton

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

JRootPane

public JRootPane()

Создает JRootPane, настраивая его glassPane, layeredPane, и contentPane.

Методы

setDoubleBuffered

public void setDoubleBuffered(boolean aFlag)

Устанавливает, использовать ли этому компоненту буфер для рисования. Если установлено в true, все рисование этого компонента будет выполняться в буфере рисования offscreen. Буфер рисования offscreen будет затем скопирован на экран. Если буферизован компонент Component и один из его предков также буферизован, будет использован буфер предка.

Overrides:: setDoubleBuffered в классе JComponent
Параметры:: aFlag - если true, установить этому компоненту буферизацию с двумя буферами
Since:: 1.6

getWindowDecorationStyle

public int getWindowDecorationStyle()

Возвращает константу, определяющую тип декораций окна, предоставляемых JRootPane.

Возвращает:: Одну из констант NONE, FRAME, PLAIN_DIALOG, INFORMATION_DIALOG, ERROR_DIALOG, COLOR_CHOOSER_DIALOG, FILE_CHOOSER_DIALOG, QUESTION_DIALOG или WARNING_DIALOG.
Since:: 1.4
См. также:: setWindowDecorationStyle(int)

setWindowDecorationStyle

public void setWindowDecorationStyle(int windowDecorationStyle)

Устанавливает тип декораций окна (такие как рамки, элементы управления для закрытия окна, заголовок...) JRootPane должен предоставлять. По умолчанию не предоставляются декорации окна (NONE).

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

Параметры:: windowDecorationStyle - Константа, определяющая декорации окна для предоставления.
Исключения:: IllegalArgumentException - если style не является одной из следующих констант: NONE, FRAME, PLAIN_DIALOG, INFORMATION_DIALOG, ERROR_DIALOG, COLOR_CHOOSER_DIALOG, FILE_CHOOSER_DIALOG, QUESTION_DIALOG, или WARNING_DIALOG.
Since:: 1.4
См. также:: JDialog.setDefaultLookAndFeelDecorated(boolean), JFrame.setDefaultLookAndFeelDecorated(boolean), LookAndFeel.getSupportsWindowDecorations()

getUI

public RootPaneUI getUI()

Возвращает объект L&F, который отображает этот компонент.

Возвращает:: LabelUI объект
Since:: 1.3

setUI

public void setUI(RootPaneUI ui)

Устанавливает объект L&F, который отображает этот компонент.

Параметры:: ui - объект L&F LabelUI
Since:: 1.3
См. также:: UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

Сбрасывает свойство UI на значение из текущего стиля отображения.

Overrides:: updateUI в классе JComponent
См. также:: JComponent.updateUI()

getUIClassID

public String getUIClassID()

Возвращает строку, которая задаёт имя класса L&F, отображающего этот компонент.

Overrides:: getUIClassID в классе JComponent
Возвращает:: строку "RootPaneUI"
См. также:: JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

createLayeredPane

protected JLayeredPane createLayeredPane()

Вызывается методами-конструкторами для создания стандартной layeredPane. По умолчанию создаёт новый JLayeredPane.

Возвращает:: стандартную layeredPane

createContentPane

protected Container createContentPane()

Вызывается методами-конструкторами для создания стандартной contentPane. По умолчанию этот метод создаёт новый JComponent и устанавливает BorderLayout в качестве его LayoutManager.

Возвращает:: стандартную contentPane

createGlassPane

protected Component createGlassPane()

Вызывается методами-конструкторами для создания стандартной glassPane. По умолчанию этот метод создаёт новый JComponent со значением видимости false.

Возвращает:: стандартную glassPane

createRootLayout

protected LayoutManager createRootLayout()

Вызывается методами-конструкторами для создания стандартной layoutManager.

Возвращает:: стандартную layoutManager.

setJMenuBar

public void setJMenuBar(JMenuBar menu)

Добавляет или изменяет панель меню, используемую в панели с слоями.

Параметры:: menu - добавляемая панель JMenuBar

setMenuBar

@Deprecated
public void setMenuBar(JMenuBar menu)

Устарело. Начиная с версии Swing 1.0.3, заменено на setJMenuBar(JMenuBar menu).

Указывает значение панели меню.

Параметры:: menu — добавляемая JMenuBar.

getJMenuBar

public JMenuBar getJMenuBar()

Возвращает строку меню из слоистой панели.

Возвращает:: используемую в панели JMenuBar

getMenuBar

@Deprecated
public JMenuBar getMenuBar()

Устаревшее. С версии Swing 1.0.3 заменено на getJMenuBar().

Возвращает значение строки меню.

Возвращает:: используемую в панели JMenuBar

setContentPane

public void setContentPane(Container content)

Устанавливает панель содержимого — контейнер, содержащий компоненты, являющиеся потомками корневой панели.

Архитектура рисования Swing требует непрозрачной JComponent в иерархии вложения. Это обычно обеспечивает панель содержимого. Если вы замените панель содержимого, рекомендуется заменить её непрозрачной JComponent.

Параметры:: content — используемая Container для содержимого компонентов
Исключения:: IllegalComponentStateException — (исключение времени выполнения), если параметр панели содержимого null

getContentPane

public Container getContentPane()

Возвращает панель содержимого — контейнер, содержащий компоненты, являющиеся потомками корневой панели.

Возвращает:: Container, содержащую содержимое компонентов

setLayeredPane

public void setLayeredPane(JLayeredPane layered)

Устанавливает слоистую панель для корневой панели. Слоистая панель, как правило, содержит панель содержимого и необязательную JMenuBar.

Параметры:: layered — используемая JLayeredPane
Исключения:: IllegalComponentStateException — (исключение времени выполнения), если параметр слоистой панели null

getLayeredPane

public JLayeredPane getLayeredPane()

Возвращает используемую корневой панелью слоистую панель. Слоистая панель обычно содержит панель содержимого и необязательную JMenuBar.

Возвращает:: текущую используемую JLayeredPane

setGlassPane

public void setGlassPane(Component glass)

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

Видимость новой панели стекла изменяется в соответствии с видимостью текущей панели стекла. Это подразумевает, что необходимо проявлять осторожность, когда требуется заменить панель стекла и сделать её видимой. Любое из следующего будет работать:

root.setGlassPane(newGlassPane);
   newGlassPane.setVisible(true);

или:

root.getGlassPane().setVisible(true);
   root.setGlassPane(newGlassPane);

Параметры:: glass — используемая Component в качестве панели стекла для этой JRootPane
Исключения:: NullPointerException — если параметр glass null

getGlassPane

public Component getGlassPane()

Возвращает текущую панель стекла для этой JRootPane.

Возвращает:: текущую панель стекла
См. также:: setGlassPane(java.awt.Component)

isValidateRoot

public boolean isValidateRoot()

Если потомок этой JRootPane вызовет revalidate, проверять с этого момента всё нижестоящее.

Отложенные запросы на повторную компоновку компонента и его потомков. Например, вызовы revalidate, передаются вверх к JRootPane или JScrollPane, потому что оба класса переопределяют isValidateRoot для возвращения true.

Переопределяет:: isValidateRoot в классе JComponent
Возвращает:: true
См. также:: JComponent.isValidateRoot(), Container.isValidateRoot()

isOptimizedDrawingEnabled

public boolean isOptimizedDrawingEnabled()

glassPane и contentPane имеют одинаковые границы, что означает, что JRootPane не разделяет своих потомков на фрагменты, и это должно возвращать false. С другой стороны, glassPane обычно не отображается, и поэтому это может возвращать true, если glassPane не отображается. Таким образом, возвращаемое значение здесь зависит от видимости glassPane.

Переопределяет:: isOptimizedDrawingEnabled в классе JComponent
Возвращает:: true, если потомки этого компонента не перекрываются

addNotify

public void addNotify()

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

Переопределяет:: addNotify в классе JComponent
См. также:: JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

removeNotify

public void removeNotify()

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

Переопределяет:: removeNotify в классе JComponent
См. также:: JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

setDefaultButton

public void setDefaultButton(JButton defaultButton)

Устанавливает свойство defaultButton, определяющее текущую кнопку по умолчанию для этой JRootPane. Кнопка по умолчанию — это кнопка, которая будет активирована при возникновении события активации, определённого UI (обычно клавиша Enter), в корневой панели независимо от того, имеет ли кнопка фокус клавиатуры (если в корневой панели нет другого компонента, который обрабатывает событие активации, например, JTextPane). Для работы активации по умолчанию кнопка должна быть включённым потомком корневой панели при возникновении активации. Чтобы удалить кнопку по умолчанию из этой корневой панели, установите это свойство в null.

Параметры:: defaultButton — кнопка, которая должна быть кнопкой по умолчанию
См. также:: JButton.isDefaultButton()

getDefaultButton

public JButton getDefaultButton()

Возвращает значение свойства defaultButton.

Возвращает:: текущую JButton, которая является кнопкой по умолчанию
См. также:: setDefaultButton(javax.swing.JButton)

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)

Переопределён для принудительного размещения компонента панели стекла как нулевого потомка.

Переопределяет:: addImpl в классе Container
Параметры:: comp — компонент, который необходимо дополнить; constraints — ограничения, которые необходимо соблюдать; index — индекс
См. также:: Container.add(Component), Container.add(Component, int), Container.add(Component, java.lang.Object), Container.invalidate(), LayoutManager, LayoutManager2

paramString

protected String paramString()

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

Переопределяет:: paramString в классе JComponent
Возвращает:: строковое представление этого JRootPane.

getAccessibleContext

public AccessibleContext getAccessibleContext()

Получает связанный с этим JRootPane AccessibleContext. Для корневых панелей AccessibleContext представляет собой AccessibleJRootPane. Новый экземпляр AccessibleJRootPane создаётся при необходимости.

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: AccessibleJRootPane, который служит AccessibleContext для этого JRootPane

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.