Класс JRootPane

public class JRootPane
extends JComponent
implements Accessible

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

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

Компоненты «тяжелого» типа (те, которые делегируют задачу виджету или нативному компоненту на хост-системе) показаны более тёмным, более толстым прямоугольником. Четыре контейнера 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.

На диаграмме справа показана структура 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, гарантирует, что:

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

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

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

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

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

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