Spec-Zone.ru › OpenJDK 25

Класс 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 можно найти в разделе Создание окон руководства Учебник по Java.

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

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

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

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

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

Начиная с версии:
1.2
См. также:
  • JRootPane
  • setDefaultCloseOperation(int)
  • WindowListener.windowClosing(WindowEvent)
  • RootPaneContainer

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

Модификатор и тип Класс Описание
protected class  JFrame.AccessibleJFrame
Этот класс реализует поддержку специальных возможностей для класса JFrame.

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

Frame.AccessibleAWTFrame

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

Window.AccessibleAWTWindow, Window.Type

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

Container.AccessibleAWTContainer

Вложенные классы и интерфейсы, объявленные в классе 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.

Поля, объявленные в классе 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

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

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

Поля, объявленные в интерфейсе 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).

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

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

Методы, объявленные в классе 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

Методы, объявленные в классе 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

Методы, объявленные в классе 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

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

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

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

getFont, postEvent

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

rootPane

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

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled
Если значение равно true, вызовы add и setLayout будут перенаправлены в contentPane. Изначально значение равно false, но при создании JFrame оно устанавливается в true.
См. также:
  • 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 экранного устройства.

Этот конструктор устанавливает для свойства локали компонента значение, возвращаемое методом 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(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): Завершать работу приложения с помощью метода exit для System. Используйте этот вариант только в приложениях.

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

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

Параметры:
operation — действие, которое следует выполнить при закрытии фрейма пользователем
Вызывает исключение:
IllegalArgumentException — если значение defaultCloseOperation не входит в число допустимых значений, перечисленных выше
См. также:
  • Window.addWindowListener(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».

Параметры:
newHandler — новый TransferHandler
Начиная с версии:
1.6
См. также:
  • TransferHandler
  • getTransferHandler()
  • Component.setDropTarget(DropTarget)

getTransferHandler

public TransferHandler getTransferHandler()
Возвращает свойство transferHandler.
Возвращает:
значение свойства transferHandler
Начиная с версии:
1.6
См. также:
  • TransferHandler
  • setTransferHandler(TransferHandler)

update

public void update(Graphics g)
Просто вызывает paint(g). Этот метод переопределен, чтобы избежать ненужного вызова очистки фона.
Переопределяет:
update в классе Container
Параметры:
g — графический контекст, в котором выполняется рисование
См. также:
  • Component.update(Graphics)

setJMenuBar

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

getJMenuBar

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

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()
Возвращает информацию о том, перенаправляются ли вызовы add и setLayout в contentPane.
Возвращает:
true, если add и setLayout перенаправляются; в противном случае false
См. также:
  • addImpl(Component, Object, int)
  • setLayout(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.
Параметры:
enabled — true, если add и setLayout перенаправляются; false, если они должны непосредственно воздействовать на JFrame.
См. также:
  • addImpl(Component, Object, int)
  • setLayout(LayoutManager)
  • isRootPaneCheckingEnabled()
  • RootPaneContainer

addImpl

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

remove

public void remove(Component comp)
Удаляет указанный компонент из контейнера. Если comp не является rootPane, вызов будет перенаправлен в contentPane. Ничего не произойдет, если comp не является дочерним компонентом JFrame или contentPane.
Переопределяет:
remove в классе Container
Параметры:
comp — удаляемый компонент
Вызывает исключение:
NullPointerException — если comp равно null
См. также:
  • Container.add(Component)
  • RootPaneContainer

setLayout

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

getRootPane

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

setRootPane

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

getContentPane

public Container getContentPane()
Возвращает объект contentPane этого фрейма.
Определено в:
getContentPane в интерфейсе RootPaneContainer
Возвращает:
свойство contentPane
См. также:
  • setContentPane(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.

Определено в:
setContentPane в интерфейсе RootPaneContainer
Параметры:
contentPane — объект contentPane этого фрейма
Вызывает исключение:
IllegalComponentStateException (исключение времени выполнения), если параметр панели содержимого равен null
См. также:
  • getContentPane()
  • RootPaneContainer.setContentPane(Container)
  • JRootPane

getLayeredPane

public JLayeredPane getLayeredPane()
Возвращает объект layeredPane этого фрейма.
Определено в:
getLayeredPane в интерфейсе RootPaneContainer
Возвращает:
свойство layeredPane
См. также:
  • setLayeredPane(JLayeredPane)
  • RootPaneContainer.getLayeredPane()

setLayeredPane

@BeanProperty(bound=false, hidden=true, description="The pane that holds the various frame layers.") public void setLayeredPane(JLayeredPane layeredPane)
Устанавливает свойство layeredPane. Этот метод вызывается конструктором.
Определено в:
setLayeredPane в интерфейсе RootPaneContainer
Параметры:
layeredPane — объект layeredPane этого фрейма
Вызывает исключение:
IllegalComponentStateException (исключение времени выполнения), если параметр многослойной панели равен null
См. также:
  • getLayeredPane()
  • RootPaneContainer.setLayeredPane(JLayeredPane)

getGlassPane

public Component getGlassPane()
Возвращает объект glassPane этого фрейма.
Определено в:
getGlassPane в интерфейсе RootPaneContainer
Возвращает:
свойство glassPane
См. также:
  • setGlassPane(Component)
  • RootPaneContainer.getGlassPane()

setGlassPane

@BeanProperty(bound=false, hidden=true, description="A transparent pane used for menu rendering.") public void setGlassPane(Component glassPane)
Устанавливает свойство glassPane. Этот метод вызывается конструктором.
Определено в:
setGlassPane в интерфейсе RootPaneContainer
Параметры:
glassPane — объект glassPane этого фрейма
См. также:
  • getGlassPane()
  • RootPaneContainer.setGlassPane(Component)

getGraphics

@BeanProperty(bound=false) public Graphics getGraphics()
Создает графический контекст для этого компонента. Если в данный момент компонент не отображается, этот метод возвращает null.
Переопределяет:
getGraphics в классе Component
Возвращает:
графический контекст для этого компонента или null, если он отсутствует
Начиная с версии:
1.6
См. также:
  • Component.paint(Graphics)

repaint

public void repaint(long time, int x, int y, int width, int height)
Перерисовывает указанный прямоугольник этого компонента в течение time миллисекунд. Подробную информацию об обработке перерисовки см. в RepaintManager.
Переопределяет:
repaint в классе Component
Параметры:
time — максимальное время в миллисекундах до обновления
x — координата x
y — координата y
width — ширина
height — высота
Начиная с версии:
1.6
См. также:
  • 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);
Параметры:
defaultLookAndFeelDecorated — подсказка о том, должен ли текущий внешний вид предоставлять оконные украшения
Начиная с версии:
1.4
См. также:
  • LookAndFeel.getSupportsWindowDecorations()

isDefaultLookAndFeelDecorated

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

paramString

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

getAccessibleContext

public AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JFrame. Для JFrame объект AccessibleContext имеет вид AccessibleJFrame. При необходимости создается новый экземпляр AccessibleJFrame.
Определено в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Frame
Возвращает:
объект AccessibleJFrame, выполняющий роль AccessibleContext этого JFrame

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, включая концептуальные обзоры, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JFrame.html

Spec-Zone.ru

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