Spec-Zone.ru › OpenJDK 24

Класс JFrame

java.lang.Object
java.awt.Component
java.awt.Container
java.awt.Window
java.awt.Frame
javax.swing.JFrame
Все реализованные интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants
@JavaBean(defaultProperty="JMenuBar", description="A toplevel window which can be minimized to an icon.") public class JFrame extends Frame implements WindowConstants, Accessible, RootPaneContainer
Расширенная версия java.awt.Frame, которая добавляет поддержку архитектуры компонентов JFC/Swing. Информацию о работе с JFrame можно найти в руководстве The Java Tutorial, в разделе Как создавать фреймы.

Класс JFrame немного несовместим с Frame. Как и все другие контейнеры верхнего уровня JFC/Swing, JFrame содержит в качестве единственного дочернего элемента JRootPane. В панели содержимого, предоставляемой корневой панелью, как правило, должны содержаться все компоненты, кроме меню, отображаемые JFrame. Это отличается от случая AWT Frame. Для удобства методы add, remove и setLayout этого класса переопределены так, что они делегируют вызовы соответствующим методам ContentPane. Например, вы можете добавить дочерний компонент в фрейм следующим образом:

       frame.add(child);
 
И дочерний элемент будет добавлен в contentPane. Панель содержимого всегда будет не равна null. Попытка установить её значение в null приведёт к тому, что JFrame выбросит исключение. В стандартной панели содержимого будет установлен менеджер BorderLayout. Подробности по добавлению, удалению и установке LayoutManager JFrame можно найти в RootPaneContainer.

В отличие от Frame, у JFrame есть представление о том, как реагировать, когда пользователь пытается закрыть окно. Стандартное поведение заключается в простом скрытии JFrame при закрытии окна пользователем. Для изменения стандартного поведения вызывается метод setDefaultCloseOperation(int). Чтобы заставить JFrame вести себя так же, как экземпляр Frame, используйте setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE).

Дополнительную информацию о панелях содержимого и других функциях, предоставляемых корневыми панелями, см. в Использование контейнеров верхнего уровня в The Java Tutorial.

В многоэкранной среде вы можете создать JFrame на другом экране. Дополнительную информацию см. в Frame.

Предупреждение: Swing не потокобезопасен. Подробнее см. Политика потоков Swing.

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

С момента:
1.2
См. также:
  • JRootPane
  • setDefaultCloseOperation(int)
  • WindowListener.windowClosing(java.awt.event.WindowEvent)
  • RootPaneContainer

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

Модификатор и тип Класс Описание
protected class  JFrame.AccessibleJFrame
Этот класс реализует поддержку доступности для класса JFrame.

Вложенные классы/интерфейсы, объявленные в классе java.awt.Frame

Frame.AccessibleAWTFrame

Вложенные классы/интерфейсы, объявленные в классе java.awt.Window

Window.AccessibleAWTWindow, Window.Type

Вложенные классы/интерфейсы, объявленные в классе java.awt.Container

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, объявленные в классе java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

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

Модификатор и тип Поле Описание
protected AccessibleContext accessibleContext
Свойство контекста доступности.
protected JRootPane rootPane
Экземпляр JRootPane, управляющий contentPane и необязательными menuBar для этого фрейма, а также glassPane.
protected boolean rootPaneCheckingEnabled
Если true, вызовы add и setLayout будут перенаправлены на contentPane.

Поля, объявленные в классе java.awt.Frame

CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR

Поля, объявленные в классе java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Поля, объявленные в интерфейсе javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

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

Конструктор Описание
JFrame()
Создаёт новый фрейм, который изначально невидим.
JFrame(GraphicsConfiguration gc)
Создаёт Frame в указанном GraphicsConfiguration устройства экрана и пустым заголовком.
JFrame(String title)
Создаёт новый, изначально невидимый Frame с указанным заголовком.
JFrame(String title, GraphicsConfiguration gc)
Создаёт JFrame с указанным заголовком и указанным GraphicsConfiguration устройства экрана.

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

Модификатор и тип Метод Описание
protected void addImpl(Component comp, Object constraints, int index)
Добавляет указанного дочернего элемента Component.
protected JRootPane createRootPane()
Вызывается методами конструктора для создания значения по умолчанию rootPane.
protected void frameInit()
Вызывается конструкторами для корректной инициализации JFrame.
AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с данным JFrame.
Container getContentPane()
Возвращает объект contentPane для данного фрейма.
int getDefaultCloseOperation()
Возвращает операцию, выполняемую при инициации пользователем действия "закрыть" для данного фрейма.
Component getGlassPane()
Возвращает объект glassPane для данного фрейма.
Graphics getGraphics()
Создаёт контекст графики для данного компонента.
JMenuBar getJMenuBar()
Возвращает установленную в этом фрейме панель меню.
JLayeredPane getLayeredPane()
Возвращает объект layeredPane для данного фрейма.
JRootPane getRootPane()
Возвращает объект rootPane для данного фрейма.
TransferHandler getTransferHandler()
Получает свойство transferHandler.
static boolean isDefaultLookAndFeelDecorated()
Возвращает true, если для недавно созданных JFrame следует использовать декор окна, предоставляемый текущим стилем.
protected boolean isRootPaneCheckingEnabled()
Возвращает, пересылаются ли вызовы add и setLayout в contentPane.
protected String paramString()
Возвращает строковое представление данного JFrame.
protected void processWindowEvent(WindowEvent e)
Обрабатывает события окна, возникающие в этом компоненте.
void remove(Component comp)
Удаляет указанный компонент из контейнера.
void repaint(long time, int x, int y, int width, int height)
Перерисовывает указанный прямоугольник этого компонента в течение time миллисекунд.
void setContentPane(Container contentPane)
Устанавливает свойство contentPane.
void setDefaultCloseOperation(int operation)
Устанавливает операцию, которая будет выполняться по умолчанию, когда пользователь инициирует "закрыть" для этого фрейма.
static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)
Предлагает подсказку о том, должны ли у вновь созданных JFrame быть декор окна (такие как рамки, виджеты для закрытия окна, заголовок) предоставляемыми текущим стилем.
void setGlassPane(Component glassPane)
Устанавливает свойство glassPane.
void setJMenuBar(JMenuBar menubar)
Устанавливает панель меню для этого фрейма.
void setLayeredPane(JLayeredPane layeredPane)
Устанавливает свойство layeredPane.
void setLayout(LayoutManager manager)
Устанавливает LayoutManager.
protected void setRootPane(JRootPane root)
Устанавливает свойство rootPane.
protected void setRootPaneCheckingEnabled(boolean enabled)
Устанавливает, пересылаются ли вызовы add и setLayout в contentPane.
void setTransferHandler(TransferHandler newHandler)
Устанавливает свойство transferHandler, которое является механизмом для поддержки передачи данных в этот компонент.
void update(Graphics g)
Просто вызывает paint(g).

Методы, объявленные в классе java.awt.Frame

addNotify, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setResizable, setState, setTitle, setUndecorated

Методы, объявленные в классе java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBackground, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setOpacity, setShape, setSize, setSize, setType, setVisible, show, toBack, toFront

Методы, объявленные в классе java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTree

Методы, объявленные в классе java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе java.awt.MenuContainer

getFont, postEvent

Подробное описание полей

rootPane

protected JRootPane rootPane
Экземпляр JRootPane, который управляет contentPane и необязательными menuBar для этого фрейма, а также glassPane.
См. также:
  • JRootPane
  • RootPaneContainer

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled
Если true, вызовы add и setLayout будут перенаправлены в contentPane. По умолчанию false, но устанавливается в true при создании JFrame.
См. также:
  • isRootPaneCheckingEnabled()
  • setRootPaneCheckingEnabled(boolean)
  • RootPaneContainer

accessibleContext

protected AccessibleContext accessibleContext
Свойство контекста доступности.

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

JFrame

public JFrame() throws HeadlessException
Создает новый фрейм, который изначально невидим.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
  • GraphicsEnvironment.isHeadless()
  • Component.setSize(int, int)
  • Component.setVisible(boolean)
  • JComponent.getDefaultLocale()

JFrame

public JFrame(GraphicsConfiguration gc)
Создает Frame в указанной GraphicsConfiguration устройства экрана и пустым заголовком.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

Параметры:
gc - GraphicsConfiguration, используемый для создания нового Frame; если gc является null, используется системная по умолчанию GraphicsConfiguration
Исключения:
IllegalArgumentException - если gc не из устройства экрана. Это исключение всегда выбрасывается, когда GraphicsEnvironment.isHeadless() возвращает true.
С:
1.3
См. также:
  • GraphicsEnvironment.isHeadless()
  • JComponent.getDefaultLocale()

JFrame

public JFrame(String title) throws HeadlessException
Создает новый, изначально невидимый Frame с заданным заголовком.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

Параметры:
title - заголовок фрейма
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
  • GraphicsEnvironment.isHeadless()
  • Component.setSize(int, int)
  • Component.setVisible(boolean)
  • JComponent.getDefaultLocale()

JFrame

public JFrame(String title, GraphicsConfiguration gc)
Создаёт JFrame с указанным заголовком и указанной GraphicsConfiguration устройства экрана.

Этот конструктор устанавливает свойство компонент locale в значение, возвращаемое JComponent.getDefaultLocale.

Параметры:
title - заголовок, отображаемый в рамке окна. Значение null обрабатывается как пустая строка "".
gc - GraphicsConfiguration, используемое для построения нового JFrame; если gc равно null, используется системная по умолчанию GraphicsConfiguration
Исключения:
IllegalArgumentException - если gc не относится к устройству экрана. Это исключение всегда выбрасывается, когда GraphicsEnvironment.isHeadless() возвращает true.
С:
1.3
См. также:
  • GraphicsEnvironment.isHeadless()
  • JComponent.getDefaultLocale()

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

frameInit

protected void frameInit()
Вызывается конструкторами для правильной инициализации JFrame.

createRootPane

protected JRootPane createRootPane()
Вызывается методами конструктора для создания стандартной rootPane.
Возвращает:
новый JRootPane

processWindowEvent

protected void processWindowEvent(WindowEvent e)
Обрабатывает события окон, возникающие в этом компоненте. Скрывает окно или удаляет его в зависимости от значения свойства defaultCloseOperation.
Переопределяет:
processWindowEvent в классе Window
Параметры:
e - событие окна
См. также:
  • setDefaultCloseOperation(int)
  • Window.processWindowEvent(java.awt.event.WindowEvent)

setDefaultCloseOperation

@BeanProperty(preferred=true, enumerationValues={"WindowConstants.DO_NOTHING_ON_CLOSE","WindowConstants.HIDE_ON_CLOSE","WindowConstants.DISPOSE_ON_CLOSE","WindowConstants.EXIT_ON_CLOSE"}, description="The frame's default close operation.") public void setDefaultCloseOperation(int operation)
Устанавливает операцию, которая будет выполнена по умолчанию, когда пользователь инициирует закрытие этого окна. Необходимо указать один из следующих вариантов:

  • DO_NOTHING_ON_CLOSE (определено в WindowConstants): Ничего не делать; требуется, чтобы программа обрабатывала операцию в методе windowClosing зарегистрированного объекта WindowListener.
  • HIDE_ON_CLOSE (определено в WindowConstants): Автоматически скрывает окно после вызова любых зарегистрированных объектов WindowListener.
  • DISPOSE_ON_CLOSE (определено в WindowConstants): Автоматически скрывает и удаляет окно после вызова любых зарегистрированных объектов WindowListener.
  • EXIT_ON_CLOSE (определено в WindowConstants): Выход из приложения с использованием метода System exit. Использовать только в приложениях.

Значение по умолчанию равно HIDE_ON_CLOSE. Изменения значения этого свойства вызывают срабатывание события изменения свойства с именем "defaultCloseOperation".

Примечание: При удалении последнего отображаемого окна в виртуальной машине Java (VM) VM может завершиться. Подробнее см. Проблемы с потоками AWT.

Параметры:
operation - операция, которая должна быть выполнена при закрытии окна
Исключения:
IllegalArgumentException - если значение defaultCloseOperation не соответствует ни одному из перечисленных выше допустимых значений
См. также:
  • Window.addWindowListener(java.awt.event.WindowListener)
  • getDefaultCloseOperation()
  • WindowConstants
  • Runtime.exit(int)

getDefaultCloseOperation

public int getDefaultCloseOperation()
Возвращает операцию, которая выполняется, когда пользователь инициирует закрытие этого окна.
Возвращает:
целое число, обозначающее операцию закрытия окна
См. также:
  • setDefaultCloseOperation(int)

setTransferHandler

@BeanProperty(hidden=true, description="Mechanism for transfer of data into the component") public void setTransferHandler(TransferHandler newHandler)
Устанавливает свойство transferHandler, которое является механизмом поддержки передачи данных в этот компонент. Используйте null, если компонент не поддерживает операции передачи данных.

Если системная переменная suppressSwingDropSupport установлена в значение false (по умолчанию) и текущий целевой объект перетаскивания на этом компоненте является либо null, либо не является целевым объектом перетаскивания, установленным пользователем, этот метод изменит целевой объект перетаскивания следующим образом: Если newHandler установлено в значение null, целевой объект перетаскивания будет очищен. Если это не так (null), будет установлен новый целевой объект перетаскивания (DropTarget).

Примечание: при использовании с JFrame, TransferHandler предоставляет только возможность импорта данных, так как методы, связанные с экспортом данных, в настоящее время типизированы как JComponent.

Для получения дополнительной информации обратитесь к разделу Использование перетаскивания и передачи данных в учебнике Java.

Parameters:
newHandler - новое значение TransferHandler
Since:
1.6
See Also:
  • TransferHandler
  • getTransferHandler()
  • Component.setDropTarget(java.awt.dnd.DropTarget)

getTransferHandler

public TransferHandler getTransferHandler()
Возвращает свойство transferHandler.
Returns:
значение свойства transferHandler
Since:
1.6
See Also:
  • TransferHandler
  • setTransferHandler(javax.swing.TransferHandler)

update

public void update(Graphics g)
Просто вызывает paint(g). Этот метод был переопределён для предотвращения ненужного вызова очистки фона.
Overrides:
update в классе Container
Parameters:
g - контекст графики для отрисовки
See Also:
  • Component.update(Graphics)

setJMenuBar

@BeanProperty(bound=false, hidden=true, description="The menubar for accessing pulldown menus from this frame.") public void setJMenuBar(JMenuBar menubar)
Устанавливает строку меню для этого фрейма.
Parameters:
menubar - строка меню, которая будет помещена в фрейм
See Also:
  • getJMenuBar()

getJMenuBar

public JMenuBar getJMenuBar()
Возвращает строку меню, установленную для этого фрейма.
Returns:
строка меню для этого фрейма
See Also:
  • setJMenuBar(javax.swing.JMenuBar)

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()
Возвращает, будут ли вызовы add и setLayout перенаправлены на contentPane.
Returns:
true, если вызовы add и setLayout перенаправляются; false в противном случае
See Also:
  • addImpl(java.awt.Component, java.lang.Object, int)
  • setLayout(java.awt.LayoutManager)
  • setRootPaneCheckingEnabled(boolean)
  • RootPaneContainer

setRootPaneCheckingEnabled

@BeanProperty(hidden=true, description="Whether the add and setLayout methods are forwarded") protected void setRootPaneCheckingEnabled(boolean enabled)
Устанавливает, будут ли вызовы add и setLayout перенаправлены на contentPane.
Parameters:
enabled - true, если вызовы add и setLayout перенаправляются, false, если они должны работать непосредственно с JFrame.
See Also:
  • addImpl(java.awt.Component, java.lang.Object, int)
  • setLayout(java.awt.LayoutManager)
  • isRootPaneCheckingEnabled()
  • RootPaneContainer

addImpl

protected void addImpl(Component comp, Object constraints, int index)
Добавляет указанного дочернего элемента Component. Этот метод переопределён, чтобы условно перенаправлять вызовы в contentPane. По умолчанию, дочерние элементы добавляются в contentPane, а не в фрейм, обратитесь к RootPaneContainer для получения подробностей.
Overrides:
addImpl в классе Container
Параметры:
comp - компонент, подлежащий дополнению
constraints - ограничения, которые следует соблюдать
index - индекс
Исключения:
IllegalArgumentException - если index некорректен
IllegalArgumentException - если к контейнеру добавляется его родитель
IllegalArgumentException - если окно добавляется в контейнер
См. также:
  • setRootPaneCheckingEnabled(boolean)
  • RootPaneContainer

remove

public void remove(Component comp)
Удаляет указанный компонент из контейнера. Если comp не является rootPane, это перенаправит вызов в contentPane. Это ничего не сделает, если comp не является дочерним элементом JFrame или contentPane.
Overrides:
remove в классе Container
Параметры:
comp - компонент, подлежащий удалению
Исключения:
NullPointerException - если comp равен null
См. также:
  • Container.add(java.awt.Component)
  • RootPaneContainer

setLayout

public void setLayout(LayoutManager manager)
Устанавливает LayoutManager. Переопределено для условного перенаправления вызова в contentPane. Дополнительную информацию см. в RootPaneContainer.
Overrides:
setLayout в классе Container
Параметры:
manager - LayoutManager
См. также:
  • setRootPaneCheckingEnabled(boolean)
  • RootPaneContainer

getRootPane

@BeanProperty(bound=false, hidden=true, description="the RootPane object for this frame.") public JRootPane getRootPane()
Возвращает объект rootPane для этого фрейма.
Specified by:
getRootPane в интерфейсе RootPaneContainer
Возвращает:
свойство rootPane
См. также:
  • setRootPane(javax.swing.JRootPane)
  • RootPaneContainer.getRootPane()

setRootPane

protected void setRootPane(JRootPane root)
Устанавливает свойство rootPane. Этот метод вызывается конструктором.
Параметры:
root - объект rootPane для этого фрейма
См. также:
  • getRootPane()

getContentPane

public Container getContentPane()
Возвращает объект contentPane для этого фрейма.
Specified by:
getContentPane в интерфейсе RootPaneContainer
Возвращает:
свойство contentPane
См. также:
  • setContentPane(java.awt.Container)
  • RootPaneContainer.getContentPane()

setContentPane

@BeanProperty(bound=false, hidden=true, description="The client area of the frame where child components are normally inserted.") public void setContentPane(Container contentPane)
Устанавливает свойство contentPane. Этот метод вызывается конструктором.

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

Specified by:
setContentPane в интерфейсе RootPaneContainer
Parameters:
contentPane - объект contentPane для этой рамки
Throws:
IllegalComponentStateException - (исключение времени выполнения) если параметр панели содержимого null
See Also:
  • getContentPane()
  • RootPaneContainer.setContentPane(java.awt.Container)
  • JRootPane

getLayeredPane

public JLayeredPane getLayeredPane()
Возвращает объект layeredPane для этой рамки.
Specified by:
getLayeredPane в интерфейсе RootPaneContainer
Returns:
свойство layeredPane
See Also:
  • setLayeredPane(javax.swing.JLayeredPane)
  • RootPaneContainer.getLayeredPane()

setLayeredPane

@BeanProperty(bound=false, hidden=true, description="The pane that holds the various frame layers.") public void setLayeredPane(JLayeredPane layeredPane)
Устанавливает свойство layeredPane. Этот метод вызывается конструктором.
Specified by:
setLayeredPane в интерфейсе RootPaneContainer
Parameters:
layeredPane - объект layeredPane для этой рамки
Throws:
IllegalComponentStateException - (исключение времени выполнения) если параметр панели слоёв null
See Also:
  • getLayeredPane()
  • RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)

getGlassPane

public Component getGlassPane()
Возвращает объект glassPane для этой рамки.
Specified by:
getGlassPane в интерфейсе RootPaneContainer
Returns:
свойство glassPane
See Also:
  • setGlassPane(java.awt.Component)
  • RootPaneContainer.getGlassPane()

setGlassPane

@BeanProperty(bound=false, hidden=true, description="A transparent pane used for menu rendering.") public void setGlassPane(Component glassPane)
Устанавливает свойство glassPane. Этот метод вызывается конструктором.
Specified by:
setGlassPane в интерфейсе RootPaneContainer
Parameters:
glassPane - объект glassPane для этой рамки
See Also:
  • getGlassPane()
  • RootPaneContainer.setGlassPane(java.awt.Component)

getGraphics

@BeanProperty(bound=false) public Graphics getGraphics()
Создаёт контекст графики для этого компонента. Этот метод вернёт null, если этот компонент в данный момент не отображается.
Overrides:
getGraphics в классе Component
Returns:
контекст графики для этого компонента или null, если его нет
Since:
1.6
See Also:
  • Component.paint(java.awt.Graphics)

repaint

public void repaint(long time, int x, int y, int width, int height)
Перерисовывает указанный прямоугольник этого компонента в течение time миллисекунд. Обратитесь к RepaintManager для получения подробной информации о том, как обрабатывается перерисовка.
Overrides:
repaint в классе Component
Parameters:
time - максимальное время в миллисекундах перед обновлением
x - координата x
y - координата y
width - ширина
height - высота
Since:
1.6
See Also:
  • RepaintManager

setDefaultLookAndFeelDecorated

public static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)
Указывает, будут ли у вновь созданных JFrame украшены окнами (такими как рамки, виджеты для закрытия окна, заголовок…) с помощью текущего внешнего вида. Если defaultLookAndFeelDecorated имеет значение true, текущий LookAndFeel поддерживает предоставление украшений окна, и текущий менеджер окон поддерживает окна без украшений, то у вновь созданных JFrame будут предоставлены украшения окна текущим LookAndFeel. В противном случае, у вновь созданных JFrame украшения окна будут предоставлены текущим менеджером окон.

Вы можете достичь того же результата для отдельного JFrame, выполнив следующие действия:

    JFrame frame = new JFrame();
    frame.setUndecorated(true);
    frame.getRootPane().setWindowDecorationStyle(JRootPane.FRAME);
 
Parameters:
defaultLookAndFeelDecorated - Указание о том, должен ли текущий внешний вид предоставлять украшения окна
Since:
1.4
See Also:
  • LookAndFeel.getSupportsWindowDecorations()

isDefaultLookAndFeelDecorated

public static boolean isDefaultLookAndFeelDecorated()
Возвращает true, если у вновь созданных JFrame должны быть украшения окна, предоставленные текущим внешним видом. Это всего лишь указание, так как некоторые внешние виды могут не поддерживать эту функцию.
Returns:
true, если внешний вид должен предоставлять украшения окна.
Since:
1.4

paramString

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

getAccessibleContext

public AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JFrame. Для JFrame AccessibleContext принимает форму AccessibleJFrame. Новый экземпляр AccessibleJFrame создается при необходимости.
Specified by:
getAccessibleContext in interface Accessible
Overrides:
getAccessibleContext in class Frame
Returns:
AccessibleJFrame, который служит AccessibleContext для этого JFrame

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

Spec-Zone.ru

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