Spec-Zone.ru › OpenJDK 17

Интерфейс RootPaneContainer

Все известные реализующие классы:
JApplet, JDialog, JFrame, JInternalFrame, JWindow
public interface RootPaneContainer
Этот интерфейс реализуется компонентами, имеющими единственного дочернего элемента JRootPane: JDialog, JFrame, JWindow, JApplet, JInternalFrame. Методы этого интерфейса — это просто обёртки для свойств JRootPane, например, getContentPane() обычно реализуется так:
     public Container getContentPane() {
         return getRootPane().getContentPane();
     }
 
Этот интерфейс служит маркером для билдеров Swing GUI, которым необходимо специально обрабатывать компоненты, такие как JFrame, содержащие один JRootPane. Например, в GUI-билдере добавление компонента на RootPaneContainer будет интерпретироваться как frame.getContentPane().add(child).

Для удобства стандартные классы, реализующие этот интерфейс (например, JFrame, JDialog, JWindow, JApplet, и JInternalFrame) переопределяют свои методы add, remove, и setLayout, чтобы делегировать вызовы соответствующим методам ContentPane. Например, вы можете добавить дочерний компонент в фрейм следующим образом:

       frame.add(child);
 
вместо:
       frame.getContentPane().add(child);
 

Поведение методов add и setLayout для JFrame, JDialog, JWindow, JApplet и JInternalFrame контролируется свойством rootPaneCheckingEnabled. Если это свойство имеет значение true (по умолчанию), то вызовы этих методов перенаправляются на contentPane; если false, эти методы работают непосредственно с RootPaneContainer. Это свойство предназначено только для подклассов и, следовательно, является защищённым.

С:
1.2
См. также:
  • JRootPane
  • JFrame
  • JDialog
  • JWindow
  • JApplet
  • JInternalFrame

Краткое описание методов

Модификатор и тип Метод Описание
Container getContentPane()
Возвращает contentPane.
Component getGlassPane()
Возвращает glassPane.
JLayeredPane getLayeredPane()
Возвращает layeredPane.
JRootPane getRootPane()
Возвращает единственный дочерний компонент JRootPane этого компонента.
void setContentPane(Container contentPane)
contentPane — это основной контейнер для компонентов, специфичных для приложения.
void setGlassPane(Component glassPane)
glassPane всегда является первым дочерним элементом rootPane, и менеджер компоновки rootPane гарантирует, что он всегда имеет такие же размеры, как rootPane.
void setLayeredPane(JLayeredPane layeredPane)
Контейнер, управляющий contentPane и, в некоторых случаях, строкой меню.

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

getRootPane

JRootPane getRootPane()
Возвращает единственный дочерний компонент JRootPane этого компонента. Обычная реализация этого интерфейса будет иметь все остальные методы, косвенно связанные с этим методом. У rootPane есть два дочерних элемента: glassPane и layeredPane.
Возвращает:
единственный дочерний компонент JRootPane этого компонента.
См. также:
  • JRootPane

setContentPane

void setContentPane(Container contentPane)
contentPane — это основной контейнер для компонентов, специфичных для приложения. Приложения должны добавлять дочерние элементы в contentPane, устанавливать его менеджер компоновки и т. д.

contentPane не может быть null.

Обычно реализуется с помощью getRootPane().setContentPane(contentPane);

Параметры:
contentPane - контейнер, используемый для содержимого этого JRootPane
Исключения:
IllegalComponentStateException - (исключение времени выполнения) если параметр contentPane равен null
См. также:
  • JRootPane.getContentPane()
  • getContentPane()

getContentPane

Container getContentPane()
Возвращает contentPane.
Возвращает:
значение свойства contentPane.
См. также:
  • setContentPane(java.awt.Container)

setLayeredPane

void setLayeredPane(JLayeredPane layeredPane)
Контейнер, управляющий contentPane и, в некоторых случаях, строкой меню. layeredPane может использоваться потомками, которые хотят добавить дочерний элемент в RootPaneContainer, который не управляется менеджером компоновки. Например, внутренний диалог или компонент эффекта перетаскивания.

layeredPane не может быть null.

Обычно реализуется с помощью

    getRootPane().setLayeredPane(layeredPane);
Параметры:
layeredPane - layered pane
Исключения:
IllegalComponentStateException - (исключение времени выполнения) если параметр layeredPane равен null
См. также:
  • getLayeredPane()
  • JRootPane.getLayeredPane()

getLayeredPane

JLayeredPane getLayeredPane()
Возвращает layeredPane.
Возвращает:
значение свойства layeredPane.
См. также:
  • setLayeredPane(javax.swing.JLayeredPane)

setGlassPane

void setGlassPane(Component glassPane)
glassPane всегда является первым дочерним элементом rootPane, и менеджер компоновки rootPane гарантирует, что он всегда имеет такие же размеры, как rootPane. По умолчанию он прозрачен и невидим. Он может быть использован для временного захвата всех ввода с клавиатуры и мыши путём добавления слушателей, а затем его отображения. По умолчанию не отображается.

glassPane не может быть null.

Обычно реализуется с помощью getRootPane().setGlassPane(glassPane);

Параметры:
glassPane - glass pane
См. также:
  • getGlassPane()
  • JRootPane.setGlassPane(java.awt.Component)

getGlassPane

Component getGlassPane()
Возвращает glassPane.
Возвращает:
значение свойства glassPane.
См. также:
  • setGlassPane(java.awt.Component)

© 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/RootPaneContainer.html

Spec-Zone.ru

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