Spec-Zone.ru › OpenJDK 21

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

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое 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 не соответствует одному из указанных выше допустимых значений
SecurityException - если EXIT_ON_CLOSE было указано и SecurityManager не позволит вызывать System.exit
См. также:
  • 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, JComponent предоставляет только возможность импорта данных, так как методы, связанные с экспортом данных, в настоящее время имеют тип JComponent.

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

Параметры:
newHandler - новое значение TransferHandler
С:
1.6
См. также:
  • TransferHandler
  • getTransferHandler()
  • Component.setDropTarget(java.awt.dnd.DropTarget)

getTransferHandler

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

Обновить

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

УстановитьСтрокуМеню

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

ПолучитьСтрокуМеню

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

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()
Возвращает, включено ли проверка корневого панели для вызовов add и setLayout. Эти вызовы будут перенаправлены на contentPane.
Возвращает:
true, если add и setLayout перенаправляются, иначе false
См. также:
  • 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.
Параметры:
enabled - true, если add и setLayout перенаправляются, false, если они должны действовать непосредственно на JFrame.
См. также:
  • 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 для подробностей.
Переопределяет:
addImpl в классе Container
Параметры:
comp - компонент, который должен быть улучшен
constraints - ограничения, которые необходимо соблюдать
index - индекс
Исключения:
IllegalArgumentException - если index недействителен
IllegalArgumentException - если к контейнеру добавляется его родительский элемент
IllegalArgumentException - если к контейнеру добавляется окно
См. также:
  • setRootPaneCheckingEnabled(boolean)
  • RootPaneContainer

удаление

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

установка макета

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 для этого фрейма.
Определено в:
getRootPane в интерфейсе RootPaneContainer
Возвращает:
свойство rootPane
См. также:
  • setRootPane(javax.swing.JRootPane)
  • RootPaneContainer.getRootPane()

setRootPane

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

getContentPane

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

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

getLayeredPane

public JLayeredPane getLayeredPane()
Возвращает объект layeredPane для этой рамки.
Определено в:
getLayeredPane в интерфейсе RootPaneContainer
Возвращает:
свойство layeredPane
См. также:
  • 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 in interface RootPaneContainer
Parameters:
layeredPane - объект layeredPane для этого фрейма
Throws:
IllegalComponentStateException - (исключение времени выполнения), если параметр слоёв null
See Also:
  • getLayeredPane()
  • RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)

getGlassPane

public Component getGlassPane()
Возвращает объект glassPane для этого фрейма.
Specified by:
getGlassPane in interface 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 in interface RootPaneContainer
Parameters:
glassPane - объект glassPane для этого фрейма
See Also:
  • getGlassPane()
  • RootPaneContainer.setGlassPane(java.awt.Component)

getGraphics

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

Перерисовка

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

УстановитьДекорациюВнешнегоВидПоУмолчанию

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

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

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

ИмеетДекорациюВнешнегоВидПоУмолчанию

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

paramString

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

getAccessibleContext

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

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/JFrame.html

Spec-Zone.ru

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