Класс 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

См. также:

END_OF_DOCUMENT_MARKER

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

Модификатор и тип	Класс	Описание
`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`	Кнопка, которая активируется, когда у панели фокус и происходит действие, специфичное для UI, например, нажатие клавиши Enter.
`static final int`	`ERROR_DIALOG`	Константа, используемая для свойства windowDecorationStyle.
`static final int`	`FILE_CHOOSER_DIALOG`	Константа, используемая для свойства windowDecorationStyle.
`static final int`	`FRAME`	Константа, используемая для свойства windowDecorationStyle.
`protected Component`	`glassPane`	Панель glassPane, которая накладывается на строку меню и панель содержимого, чтобы перехватывать движения мыши и подобные события.
`static final int`	`INFORMATION_DIALOG`	Константа, используемая для свойства windowDecorationStyle.
`protected JLayeredPane`	`layeredPane`	Панель layeredPane, которая управляет строкой меню и панелью содержимого.
`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)`	Переопределено для принудительного задания позиции компонента glass как нулевого.
`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 pane для этого `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` в качестве glass pane для этого корневого окна.
`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 должно предоставлять декорации, соответствующие для окна типа Frame.

С тех пор:

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

С тех пор:

1.4

См. также:

COLOR_CHOOSER_DIALOG

public static final int COLOR_CHOOSER_DIALOG

С тех пор:

1.4

См. также:

FILE_CHOOSER_DIALOG

public static final int FILE_CHOOSER_DIALOG

С тех пор:

1.4

См. также:

QUESTION_DIALOG

public static final int QUESTION_DIALOG

С тех пор:

1.4

См. также:

WARNING_DIALOG

public static final int WARNING_DIALOG

С тех пор:

1.4

См. также:

menuBar

protected JMenuBar menuBar

Строка меню.

contentPane

protected Container contentPane

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

layeredPane

protected JLayeredPane layeredPane

Многослойная панель, которая управляет строкой меню и панелью содержимого.

glassPane

protected Component glassPane

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

defaultButton

protected JButton defaultButton

Кнопка, которая активируется, когда у панели есть фокус, и происходит UI-специфическое действие, например, нажатие клавиши 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, который отображает этот компонент.

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

getUIClassID в классе JComponent

Возвращает:

строку "RootPaneUI"

См. также:

createLayeredPane

protected JLayeredPane createLayeredPane()

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

Возвращает:: по умолчанию layeredPane

createContentPane

protected Container createContentPane()

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

Возвращает:: стандартный 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.

Возвращает:

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

См. также:

isValidateRoot

public boolean isValidateRoot()

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

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

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

isValidateRoot в классе JComponent

Возвращает:

true

См. также:

isOptimizedDrawingEnabled

public boolean isOptimizedDrawingEnabled()

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

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

setDefaultButton

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

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

Параметры:

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

См. также:

getDefaultButton

public JButton getDefaultButton()

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

Возвращает:

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

См. также:

addImpl

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

Переопределено для обеспечения расположения компонента стекла в качестве нулевого элемента.

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

addImpl в классе Container

Параметры:

comp - компонент для расширения

constraints - ограничения, которые необходимо учитывать

index - индекс

См. также:

paramString

protected String paramString()

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

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

© 1993, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/JRootPane.html