Spec-Zone.ru › OpenJDK 17

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

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

  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.

С тех пор как:
1.2
См. также:
  • JLayeredPane
  • JMenuBar
  • JWindow
  • JFrame
  • JDialog
  • JApplet
  • JInternalFrame
  • JComponent
  • BoxLayout
  • Смешение компонентов «лёгкого» и «тяжёлого» типов
END_OF_DOCUMENT_MARKER

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

Modifier and Type Class Description
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

Краткое описание полей

Modifier and Type Field Description
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)
Переопределено для принудительного задания позиции компонента стекла в качестве нулевого дочернего элемента.
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()
Возвращает текущую область стекла для данного 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 должен предоставлять декорации, соответствующие окну 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
Константа, используемая для свойства 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, всё рисование этой компоненты будет выполняться в буфере рисования вне области экрана. Затем буфер рисования вне области экрана будет скопирован на экран. Если компонента с буфером и один из её предков также с буфером, будет использован буфер предка.
Переопределяет:
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(int)

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, INFORMATION_DIALOG, ERROR_DIALOG, COLOR_CHOOSER_DIALOG, FILE_CHOOSER_DIALOG, QUESTION_DIALOG, или WARNING_DIALOG.
С момента:
1.4
См. также:
  • JDialog.setDefaultLookAndFeelDecorated(boolean)
  • JFrame.setDefaultLookAndFeelDecorated(boolean)
  • LookAndFeel.getSupportsWindowDecorations()

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
См. также:
  • UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()
Сбрасывает свойство UI на значение из текущей темы оформления.
Переопределяет:
updateUI в классе JComponent
См. также:
  • JComponent.updateUI()

getUIClassID

public String getUIClassID()
Возвращает строку, которая указывает имя класса L&F, который отрисовывает эту компоненту.
Переопределяет:
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.
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)
Устарело.
Начиная со Swing версии 1.0.3 заменено на setJMenuBar(JMenuBar menu).
Устанавливает значение панели меню.
Parameters:
menu - добавляемую JMenuBar.

getJMenuBar

public JMenuBar getJMenuBar()
Возвращает панель меню из слоистой панели.
Returns:
используемую в панели JMenuBar

getMenuBar

@Deprecated public JMenuBar getMenuBar()
Устарело.
Начиная со 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:
  • setGlassPane(java.awt.Component)

isValidateRoot

public boolean isValidateRoot()
Если потомок этой JRootPane вызывает revalidate, валидировать отсюда вниз.

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

Overrides:
isValidateRoot в классе JComponent
Returns:
true
See Also:
  • JComponent.isValidateRoot()
  • Container.isValidateRoot()

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:
  • JButton.isDefaultButton()

getDefaultButton

public JButton getDefaultButton()
Возвращает значение свойства defaultButton.
Returns:
текущую кнопку по умолчанию
See Also:
  • setDefaultButton(javax.swing.JButton)

addImpl

protected void addImpl(Component comp, Object constraints, int index)
Переопределено, чтобы обеспечить позиционирование компонента-стекла как нулевого потомка.
Overrides:
addImpl в классе Container
Parameters:
comp - компонент, который необходимо улучшить
constraints - ограничения, которые следует учитывать
index - индекс
See Also:
  • Container.add(Component)
  • Container.add(Component, int)
  • Container.add(Component, java.lang.Object)
  • Container.invalidate()
  • LayoutManager
  • LayoutManager2

paramString

protected String paramString()
Возвращает строковое представление этого JRootPane. Этот метод предназначен только для отладки, и содержание и формат возвращаемой строки могут отличаться в различных реализациях. Возвращаемая строка может быть пустой, но не null.
Overrides:
paramString в классе JComponent
Returns:
строковое представление этого JRootPane.

getAccessibleContext

public AccessibleContext getAccessibleContext()
Получает AccessibleContext, связанный с этим JRootPane. Для корневых панелей AccessibleContext представляется в виде AccessibleJRootPane. Новый экземпляр AccessibleJRootPane создается при необходимости.
Указано в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Component
Возвращает:
объект AccessibleJRootPane, который служит AccessibleContext этого JRootPane

© 1993, 2021, 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/17/docs/api/java.desktop/javax/swing/JRootPane.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API