Класс JRootPane

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.

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

Примечание: Метод JComponent getRootPane можно использовать для получения JRootPane, содержащего данный компонент.

Пример:

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.

Примечание: Менеджер компоновки по умолчанию для contentPane — BorderLayout-менеджер. Однако JRootPane использует пользовательский LayoutManager. Поэтому при изменении менеджера компоновки для компонентов, добавленных в JRootPane, используйте код, подобный этому:
    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.

С:

1.2

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`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 final int`	`COLOR_CHOOSER_DIALOG`	Константа, используемая для свойства windowDecorationStyle.
`protected Container`	`contentPane`	Панель содержимого.
`protected JButton`	`defaultButton`	Кнопка, которая активируется, когда у панели есть фокус, и происходит действие, специфичное для интерфейса, например, нажатие клавиши Enter.
`static final int`	`ERROR_DIALOG`	Константа, используемая для свойства windowDecorationStyle.
`static final int`	`FILE_CHOOSER_DIALOG`	Константа, используемая для свойства windowDecorationStyle.
`static final int`	`FRAME`	Константа, используемая для свойства windowDecorationStyle.
`protected Component`	`glassPane`	Панель glassPane, которая накладывается на menu bar и content pane, чтобы перехватывать движения мыши и подобные действия.
`static final int`	`INFORMATION_DIALOG`	Константа, используемая для свойства windowDecorationStyle.
`protected JLayeredPane`	`layeredPane`	Панель layered pane, которая управляет menu bar и content pane.
`protected JMenuBar`	`menuBar`	Панель меню.
`static final int`	`NONE`	Константа, используемая для свойства windowDecorationStyle.
`static final int`	`PLAIN_DIALOG`	Константа, используемая для свойства windowDecorationStyle.
`static final int`	`QUESTION_DIALOG`	Константа, используемая для свойства windowDecorationStyle.
`static final 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)`	Переопределено для принудительного задания позиции компонента стекла как нулевого.
`protected Container`	`createContentPane()`	Вызывается методами-конструкторами для создания стандартного `contentPane`.
`protected Component`	`createGlassPane()`	Вызывается методами-конструкторами для создания стандартного `glassPane`.
`protected JLayeredPane`	`createLayeredPane()`	Вызывается методами-конструкторами для создания стандартного `layeredPane`.
`protected LayoutManager`	`createRootLayout()`	Вызывается методами-конструкторами для создания стандартного `layoutManager`.
`AccessibleContext`	`getAccessibleContext()`	Возвращает связанный с данным `JRootPane` `AccessibleContext`.
`Container`	`getContentPane()`	Возвращает область содержимого — контейнер, который содержит компоненты, привязанные к корневой панели.
`JButton`	`getDefaultButton()`	Возвращает значение свойства `defaultButton`.
`Component`	`getGlassPane()`	Возвращает текущее стекло для данного `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` не выкладывает свои дочерние элементы, и это должно возвращать false.
`boolean`	`isValidateRoot()`	Если потомок этого `JRootPane` вызывает `revalidate`, выполните проверку с этого момента вниз.
`protected String`	`paramString()`	Возвращает строковое представление данного `JRootPane`.
`void`	`setContentPane(Container content)`	Устанавливает область содержимого — контейнер, который содержит компоненты, привязанные к корневой панели.
`void`	`setDefaultButton(JButton defaultButton)`	Устанавливает свойство `defaultButton`, которое определяет текущую стандартную кнопку для этого `JRootPane`.
`void`	`setDoubleBuffered(boolean aFlag)`	Устанавливает, следует ли данному компоненту использовать буфер для рисования.
`void`	`setGlassPane(Component glass)`	Устанавливает указанное `Component` в качестве стекла для этой корневой панели.
`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, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, 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, removeNotify, 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, 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, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, 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 не должен предоставлять каких-либо декораций окна.

С:

1.4

См. также:

FRAME

public static final int FRAME

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

С:

1.4

См. также:

PLAIN_DIALOG

public static final int PLAIN_DIALOG

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

С:

1.4

См. также:

INFORMATION_DIALOG

public static final int INFORMATION_DIALOG

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

С:

1.4

См. также:

ERROR_DIALOG

public static final int ERROR_DIALOG

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

С:

1.4

См. также:

COLOR_CHOOSER_DIALOG

public static final int COLOR_CHOOSER_DIALOG

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

С:

1.4

См. также:

FILE_CHOOSER_DIALOG

public static final int FILE_CHOOSER_DIALOG

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

С:

1.4

См. также:

QUESTION_DIALOG

public static final int QUESTION_DIALOG

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

С:

1.4

См. также:

WARNING_DIALOG

public static final int WARNING_DIALOG

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

С:

1.4

См. также:

menuBar

protected JMenuBar menuBar

Панель меню.

contentPane

protected Container contentPane

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

layeredPane

protected JLayeredPane layeredPane

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

glassPane

protected Component glassPane

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

defaultButton

protected JButton defaultButton

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

Подробное описание конструкторов

JRootPane

public JRootPane()

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

Подробное описание методов

setDoubleBuffered

public void setDoubleBuffered(boolean aFlag)

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

Переопределяет:: setDoubleBuffered в классе JComponent
Параметры:: aFlag - если true, установить этой компоненте буферизацию с двойным буфером
С:: 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.

С:

1.4

См. также:

setWindowDecorationStyle

@BeanProperty(expert=true, visualUpdate=true, enumerationValues={"JRootPane.NONE","JRootPane.FRAME","JRootPane.PLAIN_DIALOG","JRootPane.INFORMATION_DIALOG","JRootPane.ERROR_DIALOG","JRootPane.COLOR_CHOOSER_DIALOG","JRootPane.FILE_CHOOSER_DIALOG","JRootPane.QUESTION_DIALOG","JRootPane.WARNING_DIALOG"}, description="Identifies the type of Window decorations to provide") 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.

С:

1.4

См. также:

getUI

public RootPaneUI getUI()

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

Переопределяет:: getUI в классе JComponent
Возвращает:: LabelUI объект
С:: 1.3

setUI

@BeanProperty(expert=true, hidden=true, visualUpdate=true, description="The UI object that implements the Component's LookAndFeel.") public void setUI(RootPaneUI ui)

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

Параметры:

ui - объект L&F LabelUI

С:

1.3

См. также:

updateUI

public void updateUI()

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

Переопределяет:

updateUI в классе JComponent

См. также:

getUIClassID

public String getUIClassID()

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

Overrides:

getUIClassID в классе JComponent

Returns:

строка "RootPaneUI"

See Also:

createLayeredPane

protected JLayeredPane createLayeredPane()

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

Returns:: стандартный layeredPane

createContentPane

protected Container createContentPane()

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

Returns:: стандартный contentPane

createGlassPane

protected Component createGlassPane()

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

Returns:: стандартный glassPane

createRootLayout

protected LayoutManager createRootLayout()

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

Returns:: стандартный layoutManager.

setJMenuBar

public void setJMenuBar(JMenuBar menu)

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

Parameters:: menu - добавляемая JMenuBar

setMenuBar

@Deprecated public void setMenuBar(JMenuBar menu)

Deprecated.

С версии Swing 1.0.3 заменено на setJMenuBar(JMenuBar menu).

Устанавливает значение строки меню.

Parameters:: menu - добавляемая JMenuBar

getJMenuBar

public JMenuBar getJMenuBar()

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

Returns:: используемая в панели JMenuBar

getMenuBar

@Deprecated public JMenuBar getMenuBar()

Deprecated.

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

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

Returns:: используемая в панели JMenuBar

setContentPane

public void setContentPane(Container content)

Устанавливает содержимое панели – контейнер, содержащий компоненты, унаследованные от корневой панели.

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

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

getContentPane

public Container getContentPane()

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

Returns:: Container, содержащий содержимое компонентов

setLayeredPane

public void setLayeredPane(JLayeredPane layered)

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

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

getLayeredPane

public JLayeredPane getLayeredPane()

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

Returns:: текущую используемую JLayeredPane

setGlassPane

public void setGlassPane(Component glass)

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

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

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

или:

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

Parameters:: glass - используемая Component в качестве панели стекла для этой JRootPane
Throws:: NullPointerException - если параметр glass null

getGlassPane

public Component getGlassPane()

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

Returns:

текущую панель стекла

See Also:

isValidateRoot

public boolean isValidateRoot()

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

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

Overrides:

isValidateRoot в классе JComponent

Returns:

true

See Also:

isOptimizedDrawingEnabled

public boolean isOptimizedDrawingEnabled()

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

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

setDefaultButton

@BeanProperty(description="The button activated by default in this root pane") public void setDefaultButton(JButton defaultButton)

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

Parameters:

defaultButton - кнопка, которая должна быть кнопкой по умолчанию

See Also:

getDefaultButton

public JButton getDefaultButton()

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

Returns:

JButton, которая в настоящее время является кнопкой по умолчанию

See Also:

addImpl

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

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

Overrides:

addImpl в классе Container

Параметры:

comp - компонент, который нужно улучшить

constraints - ограничения, которые нужно соблюдать

index - индекс

См. также:

paramString

protected String paramString()

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе Component
Возвращает:: объект AccessibleJRootPane, который служит контекстом доступности этого JRootPane

© 1993, 2025, 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/JRootPane.html