Spec-Zone.ru › OpenJDK 25

Класс Frame

java.lang.Object
java.awt.Component
java.awt.Container
java.awt.Window
java.awt.Frame
Все реализуемые интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible
Непосредственные известные подклассы:
JFrame
public class Frame extends Window implements MenuContainer
Frame — это окно верхнего уровня с заголовком и рамкой.

Размер окна включает область, отведённую под рамку. Размеры области рамки можно получить с помощью метода getInsets, однако, поскольку они зависят от платформы, корректное значение insets нельзя получить, пока окно не станет отображаемым в результате вызова pack или show. Поскольку область рамки включена в общий размер окна, рамка фактически закрывает его часть, ограничивая область, доступную для отрисовки и/или отображения подкомпонентов прямоугольником с координатами верхнего левого угла (insets.left, insets.top) и размерами width - (insets.left + insets.right) на height - (insets.top + insets.bottom).

Раскладка по умолчанию для окна — BorderLayout.

Собственные элементы оформления окна (то есть Frame и Titlebar) можно отключить с помощью setUndecorated. Это можно сделать только тогда, когда окно не является displayable.

В многомониторной среде можно создать Frame на другом экранном устройстве, создав Frame с помощью Frame(GraphicsConfiguration) или Frame(String title, GraphicsConfiguration). Объект GraphicsConfiguration является одним из объектов GraphicsConfiguration целевого экранного устройства.

В многомониторной среде с виртуальными устройствами, где область рабочего стола может охватывать несколько физических экранных устройств, границы всех конфигураций задаются относительно системы виртуальных координат. Начало системы виртуальных координат находится в верхнем левом углу основного физического экрана. В зависимости от расположения основного экрана в виртуальном устройстве возможны отрицательные координаты, как показано на рисунке ниже.

Diagram of virtual device encompassing three physical screens and one primary physical screen. The primary physical screen shows (0,0) coords while a different physical screen shows (-80,-100) coords.

В такой среде при вызове setLocation необходимо передать этому методу виртуальные координаты. Аналогично, вызов getLocationOnScreen для Frame возвращает координаты виртуального устройства. Вызовите метод getBounds объекта GraphicsConfiguration, чтобы определить его начало в системе виртуальных координат.

Следующий код задаёт расположение Frame в точке (10, 10) относительно начала координат физического экрана соответствующего GraphicsConfiguration. Если не учитывать границы GraphicsConfiguration, расположение Frame будет задано в точке (10, 10) относительно системы виртуальных координат, и окно появится на основном физическом экране, который может отличаться от физического экрана указанного GraphicsConfiguration. 

     Frame f = new Frame(GraphicsConfiguration gc);
     Rectangle bounds = gc.getBounds();
     f.setLocation(10 + bounds.x, 10 + bounds.y);

Окна могут генерировать следующие типы WindowEvent:

  • WINDOW_OPENED
  • WINDOW_CLOSING:
    Если программа явно не скроет окно и не освободит связанные с ним ресурсы при обработке этого события, операция закрытия окна будет отменена.
  • WINDOW_CLOSED
  • WINDOW_ICONIFIED
  • WINDOW_DEICONIFIED
  • WINDOW_ACTIVATED
  • WINDOW_DEACTIVATED
  • WINDOW_GAINED_FOCUS
  • WINDOW_LOST_FOCUS
  • WINDOW_STATE_CHANGED
С версии:
1.0
См. также:
  • WindowEvent
  • Window.addWindowListener(WindowListener)
  • Сериализованная форма

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

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

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

Window.AccessibleAWTWindow, Window.Type

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

Container.AccessibleAWTContainer

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

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

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

Модификатор и тип Поле Описание
static final int CROSSHAIR_CURSOR
Устарело.
заменено на Cursor.CROSSHAIR_CURSOR.
static final int DEFAULT_CURSOR
Устарело.
заменено на Cursor.DEFAULT_CURSOR.
static final int E_RESIZE_CURSOR
Устарело.
заменено на Cursor.E_RESIZE_CURSOR.
static final int HAND_CURSOR
Устарело.
заменено на Cursor.HAND_CURSOR.
static final int ICONIFIED
Этот бит состояния указывает, что окно свёрнуто.
static final int MAXIMIZED_BOTH
Эта маска битов состояния указывает, что окно развёрнуто на весь экран (как по горизонтали, так и по вертикали).
static final int MAXIMIZED_HORIZ
Этот бит состояния указывает, что окно развёрнуто по горизонтали.
static final int MAXIMIZED_VERT
Этот бит состояния указывает, что окно развёрнуто по вертикали.
static final int MOVE_CURSOR
Устарело.
заменено на Cursor.MOVE_CURSOR.
static final int N_RESIZE_CURSOR
Устарело.
заменено на Cursor.N_RESIZE_CURSOR.
static final int NE_RESIZE_CURSOR
Устарело.
заменено на Cursor.NE_RESIZE_CURSOR.
static final int NORMAL
Окно находится в «обычном» состоянии.
static final int NW_RESIZE_CURSOR
Устарело.
заменено на Cursor.NW_RESIZE_CURSOR.
static final int S_RESIZE_CURSOR
Устарело.
заменено на Cursor.S_RESIZE_CURSOR.
static final int SE_RESIZE_CURSOR
Устарело.
заменено на Cursor.SE_RESIZE_CURSOR.
static final int SW_RESIZE_CURSOR
Устарело.
заменено на Cursor.SW_RESIZE_CURSOR.
static final int TEXT_CURSOR
Устарело.
заменено на Cursor.TEXT_CURSOR.
static final int W_RESIZE_CURSOR
Устарело.
заменено на Cursor.W_RESIZE_CURSOR.
static final int WAIT_CURSOR
Устарело.
заменено на Cursor.WAIT_CURSOR.

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

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

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

Модификатор и тип Метод Описание
void addNotify()
Делает этот Frame отображаемым, подключая его к собственному экранному ресурсу.
AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим Frame.
int getCursorType()
Устарело.
Начиная с JDK версии 1.1 заменено на Component.getCursor().
int getExtendedState()
Возвращает состояние этого окна.
static Frame[] getFrames()
Возвращает массив всех Frame, созданных этим приложением.
Image getIconImage()
Возвращает изображение, которое будет отображаться в качестве значка этого окна.
Rectangle getMaximizedBounds()
Возвращает максимальные границы этого окна.
MenuBar getMenuBar()
Возвращает строку меню этого окна.
int getState()
Возвращает состояние этого окна (устаревший метод).
String getTitle()
Возвращает заголовок окна.
boolean isResizable()
Указывает, может ли пользователь изменять размер этого окна.
boolean isUndecorated()
Указывает, не имеет ли это окно элементов оформления.
protected String paramString()
Возвращает строковое представление состояния этого Frame.
void remove(MenuComponent m)
Удаляет указанную строку меню из этого окна.
void removeNotify()
Делает этот Frame неотображаемым, отключая его от собственного экранного ресурса.
void setCursor(int cursorType)
Устарело.
Начиная с JDK версии 1.1 заменено на Component.setCursor(Cursor).
void setExtendedState(int state)
Задаёт состояние этого окна.
void setMaximizedBounds(Rectangle bounds)
Задаёт максимальные границы этого окна.
void setMenuBar(MenuBar mb)
Задаёт для этого окна указанную строку меню.
void setResizable(boolean resizable)
Задаёт, может ли пользователь изменять размер этого окна.
void setState(int state)
Задаёт состояние этого окна (устаревший метод).
void setTitle(String title)
Задаёт для этого окна указанный заголовок.
void setUndecorated(boolean undecorated)
Отключает или включает элементы оформления этого окна.

Методы, объявленные в классе 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, processWindowEvent, 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, addImpl, 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, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, 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, getGraphics, 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, 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

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

DEFAULT_CURSOR

@Deprecated public static final int DEFAULT_CURSOR
Устарело.
заменено на Cursor.DEFAULT_CURSOR.
См. также:
  • Значения констант полей

CROSSHAIR_CURSOR

@Deprecated public static final int CROSSHAIR_CURSOR
Устарело.
заменено на Cursor.CROSSHAIR_CURSOR.
См. также:
  • Значения констант полей

TEXT_CURSOR

@Deprecated public static final int TEXT_CURSOR
Устарело.
заменено на Cursor.TEXT_CURSOR.
См. также:
  • Значения констант полей

WAIT_CURSOR

@Deprecated public static final int WAIT_CURSOR
Устарело.
заменено на Cursor.WAIT_CURSOR.
См. также:
  • Значения констант полей

SW_RESIZE_CURSOR

@Deprecated public static final int SW_RESIZE_CURSOR
Устарело.
заменено на Cursor.SW_RESIZE_CURSOR.
См. также:
  • Значения констант полей

SE_RESIZE_CURSOR

@Deprecated public static final int SE_RESIZE_CURSOR
Устарело.
заменено на Cursor.SE_RESIZE_CURSOR.
См. также:
  • Значения констант полей

NW_RESIZE_CURSOR

@Deprecated public static final int NW_RESIZE_CURSOR
Устарело.
заменено на Cursor.NW_RESIZE_CURSOR.
См. также:
  • Значения констант полей

NE_RESIZE_CURSOR

@Deprecated public static final int NE_RESIZE_CURSOR
Устарело.
заменено на Cursor.NE_RESIZE_CURSOR.
См. также:
  • Значения констант полей

N_RESIZE_CURSOR

@Deprecated public static final int N_RESIZE_CURSOR
Устарело.
заменено на Cursor.N_RESIZE_CURSOR.
См. также:
  • Значения констант полей

S_RESIZE_CURSOR

@Deprecated public static final int S_RESIZE_CURSOR
Устарело.
заменено на Cursor.S_RESIZE_CURSOR.
См. также:
  • Значения констант полей

W_RESIZE_CURSOR

@Deprecated public static final int W_RESIZE_CURSOR
Устарело.
заменено на Cursor.W_RESIZE_CURSOR.
См. также:
  • Значения констант полей

E_RESIZE_CURSOR

@Deprecated public static final int E_RESIZE_CURSOR
Устарело.
заменено на Cursor.E_RESIZE_CURSOR.
См. также:
  • Значения констант полей

HAND_CURSOR

@Deprecated public static final int HAND_CURSOR
Устарело.
заменено на Cursor.HAND_CURSOR.
См. также:
  • Значения констант полей

MOVE_CURSOR

@Deprecated public static final int MOVE_CURSOR
Устарело.
заменено на Cursor.MOVE_CURSOR.
См. также:
  • Значения констант полей

NORMAL

public static final int NORMAL
Рамка находится в «обычном» состоянии. Эта символьная константа обозначает состояние рамки, в котором все биты состояния сброшены.
См. также:
  • setExtendedState(int)
  • getExtendedState()
  • Значения констант полей

ICONIFIED

public static final int ICONIFIED
Этот бит состояния указывает, что рамка свёрнута в значок.
См. также:
  • setExtendedState(int)
  • getExtendedState()
  • Значения констант полей

MAXIMIZED_HORIZ

public static final int MAXIMIZED_HORIZ
Этот бит состояния указывает, что рамка развёрнута по горизонтали.
Начиная с:
1.4
См. также:
  • setExtendedState(int)
  • getExtendedState()
  • Значения констант полей

MAXIMIZED_VERT

public static final int MAXIMIZED_VERT
Этот бит состояния указывает, что рамка развёрнута по вертикали.
Начиная с:
1.4
См. также:
  • setExtendedState(int)
  • getExtendedState()
  • Значения констант полей

MAXIMIZED_BOTH

public static final int MAXIMIZED_BOTH
Эта маска битов состояния указывает, что рамка развёрнута полностью (то есть и по горизонтали, и по вертикали). Это лишь удобный псевдоним для MAXIMIZED_VERT | MAXIMIZED_HORIZ.

Обратите внимание: правильная проверка того, что рамка развёрнута полностью, выглядит так: 

    (state & Frame.MAXIMIZED_BOTH) == Frame.MAXIMIZED_BOTH

Чтобы проверить, развёрнута ли рамка в каком-либо направлении, используйте 

    (state & Frame.MAXIMIZED_BOTH) != 0
Начиная с:
1.4
См. также:
  • setExtendedState(int)
  • getExtendedState()
  • Значения констант полей

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

Frame

public Frame() throws HeadlessException
Создаёт новый экземпляр Frame, изначально невидимый. Заголовок Frame пуст.
Исключения:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
См. также:
  • GraphicsEnvironment.isHeadless()
  • Component.setSize(int, int)
  • Component.setVisible(boolean)

Frame

public Frame(GraphicsConfiguration gc)
Создаёт новый, изначально невидимый объект Frame с указанной конфигурацией GraphicsConfiguration.
Параметры:
gc — GraphicsConfiguration целевого экранного устройства. Если gc равен null, предполагается конфигурация GraphicsConfiguration, используемая по умолчанию в системе.
Исключения:
IllegalArgumentException — если gc не относится к экранному устройству.
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
Начиная с:
1.3
См. также:
  • GraphicsEnvironment.isHeadless()

Frame

public Frame(String title) throws HeadlessException
Создаёт новый, изначально невидимый объект Frame с указанным заголовком.
Параметры:
title — заголовок, отображаемый в рамке окна. Значение null трактуется как пустая строка, "".
Исключения:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
См. также:
  • GraphicsEnvironment.isHeadless()
  • Component.setSize(int, int)
  • Component.setVisible(boolean)
  • GraphicsConfiguration.getBounds()

Frame

public Frame(String title, GraphicsConfiguration gc)
Создаёт новый, изначально невидимый объект Frame с указанным заголовком и конфигурацией GraphicsConfiguration.
Параметры:
title — заголовок, отображаемый в рамке окна. Значение null трактуется как пустая строка, "".
gc — GraphicsConfiguration целевого экранного устройства. Если gc равен null, предполагается конфигурация GraphicsConfiguration, используемая по умолчанию в системе.
Исключения:
IllegalArgumentException — если gc не относится к экранному устройству.
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true
Начиная с:
1.3
См. также:
  • GraphicsEnvironment.isHeadless()
  • Component.setSize(int, int)
  • Component.setVisible(boolean)
  • GraphicsConfiguration.getBounds()

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

addNotify

public void addNotify()
Делает эту рамку отображаемой, связывая её с системным экранным ресурсом. При переводе рамки в отображаемое состояние все её дочерние компоненты также становятся отображаемыми. Этот метод вызывается внутри инструментария и не должен вызываться программами напрямую.
Переопределяет:
addNotify в классе Window
См. также:
  • Component.isDisplayable()
  • removeNotify()

getTitle

public String getTitle()
Возвращает заголовок рамки. Заголовок отображается в рамке окна.
Возвращает:
заголовок этой рамки или пустую строку ("") если у рамки нет заголовка.
См. также:
  • setTitle(String)

setTitle

public void setTitle(String title)
Задаёт для этой рамки указанный заголовок.
Параметры:
title — заголовок, отображаемый в рамке окна. Значение null трактуется как пустая строка, "".
См. также:
  • getTitle()

getIconImage

public Image getIconImage()
Возвращает изображение, отображаемое в качестве значка этой рамки.

Этот метод устарел и сохранён только для обратной совместимости. Вместо него используйте Window.getIconImages().

Если для значка окна был задан список изображений, этот метод возвращает первый элемент списка.

Возвращает:
изображение значка этой рамки или null, если у рамки нет изображения значка.
См. также:
  • Window.setIconImage(Image)
  • Window.getIconImages()
  • Window.setIconImages(List)

getMenuBar

public MenuBar getMenuBar()
Возвращает строку меню этой рамки.
Возвращает:
строку меню этой рамки или null, если у рамки нет строки меню.
См. также:
  • setMenuBar(MenuBar)

setMenuBar

public void setMenuBar(MenuBar mb)
Задаёт для этой рамки указанную строку меню.
Параметры:
mb — задаваемая строка меню. Если этот параметр равен null, существующая строка меню рамки удаляется.
См. также:
  • getMenuBar()

isResizable

public boolean isResizable()
Показывает, может ли пользователь изменять размер этой рамки. По умолчанию все рамки изначально допускают изменение размера.
Возвращает:
true, если пользователь может изменять размер этой рамки; в противном случае — false.
См. также:
  • setResizable(boolean)

setResizable

public void setResizable(boolean resizable)
Задаёт, может ли пользователь изменять размер этой рамки.
Параметры:
resizable — true, если размер этой рамки можно изменять; в противном случае — false.
См. также:
  • isResizable()

setState

public void setState(int state)
Задаёт состояние этой рамки (устаревший метод).

В более ранних версиях JDK состояние рамки могло быть только NORMAL или ICONIFIED. Начиная с JDK 1.4 набор поддерживаемых состояний рамки расширен, а состояние представляется битовой маской.

Для совместимости с приложениями, разработанными ранее, этот метод по-прежнему принимает только Frame.NORMAL и Frame.ICONIFIED. Метод изменяет только свёрнутое состояние рамки, не затрагивая другие аспекты её состояния. Если переданное методу состояние не равно ни Frame.NORMAL, ни Frame.ICONIFIED, метод не выполняет никаких действий.

Обратите внимание: если состояние не поддерживается на данной платформе, ни состояние, ни возвращаемое значение метода getState() не изменятся. Приложение может определить, поддерживается ли конкретное состояние, с помощью метода Toolkit.isFrameStateSupported(int).

Если рамка в данный момент видна на экране (метод Window.isShowing() возвращает true), разработчику следует проверить возвращаемое значение метода WindowEvent.getNewState() объекта WindowEvent, полученного через WindowStateListener, чтобы определить, действительно ли состояние изменилось.

Если рамка не видна на экране, события могут быть созданы, а могут и не быть. В этом случае разработчик может считать, что состояние изменяется сразу после возврата этого метода. Позднее, при вызове метода setVisible(true), рамка попытается применить это состояние. При этом получение каких-либо событий WindowEvent.WINDOW_STATE_CHANGED также не гарантируется.

Параметры:
state — либо Frame.NORMAL, либо Frame.ICONIFIED.
См. также:
  • setExtendedState(int)
  • Window.addWindowStateListener(WindowStateListener)

setExtendedState

public void setExtendedState(int state)
Задаёт состояние этой рамки. Состояние представляется битовой маской.
  • NORMAL
    Указывает, что ни один бит состояния не установлен.
  • ICONIFIED
  • MAXIMIZED_HORIZ
  • MAXIMIZED_VERT
  • MAXIMIZED_BOTH
    Объединяет MAXIMIZED_HORIZ и MAXIMIZED_VERT.

Обратите внимание: если состояние не поддерживается на данной платформе, ни состояние, ни возвращаемое значение метода getExtendedState() не изменятся. Приложение может определить, поддерживается ли конкретное состояние, с помощью метода Toolkit.isFrameStateSupported(int).

Если рамка в данный момент видна на экране (метод Window.isShowing() возвращает true), разработчику следует проверить возвращаемое значение метода WindowEvent.getNewState() объекта WindowEvent, полученного через WindowStateListener, чтобы определить, действительно ли состояние изменилось.

Если рамка не видна на экране, события могут быть созданы, а могут и не быть. В этом случае разработчик может считать, что состояние изменяется сразу после возврата этого метода. Позднее, при вызове метода setVisible(true), рамка попытается применить это состояние. При этом получение каких-либо событий WindowEvent.WINDOW_STATE_CHANGED также не гарантируется.

Параметры:
state — битовая маска констант состояния рамки
Начиная с:
1.4
См. также:
  • Window.addWindowStateListener(WindowStateListener)

getState

public int getState()
Возвращает состояние этой рамки (устаревший метод).

В более ранних версиях JDK состояние рамки могло быть только NORMAL или ICONIFIED. Начиная с JDK 1.4 набор поддерживаемых состояний рамки расширен, а состояние представляется битовой маской.

Для совместимости со старыми программами этот метод по-прежнему возвращает Frame.NORMAL и Frame.ICONIFIED, но сообщает только о свёрнутом состоянии рамки; другие аспекты её состояния этим методом не отображаются.

Возвращает:
Frame.NORMAL или Frame.ICONIFIED.
См. также:
  • setState(int)
  • getExtendedState()

getExtendedState

public int getExtendedState()
Возвращает состояние этой рамки. Состояние представляется битовой маской.
  • NORMAL
    Указывает, что ни один бит состояния не установлен.
  • ICONIFIED
  • MAXIMIZED_HORIZ
  • MAXIMIZED_VERT
  • MAXIMIZED_BOTH
    Объединяет MAXIMIZED_HORIZ и MAXIMIZED_VERT.
Возвращает:
битовую маску констант состояния рамки
Начиная с:
1.4
См. также:
  • setExtendedState(int)

setMaximizedBounds

public void setMaximizedBounds(Rectangle bounds)
Задаёт границы развёрнутого состояния этой рамки.

Когда рамка находится в развёрнутом состоянии, система предоставляет некоторые значения границ по умолчанию. Этот метод позволяет переопределить некоторые или все значения, предоставленные системой.

Если bounds равен null, принимаются границы, заданные системой. Если значение не равно null, можно переопределить некоторые значения, предоставленные системой, и принять остальные, задав для полей, значения которых следует принять от системы, значение Integer.MAX_VALUE.

Обратите внимание: заданные границы развёрнутого состояния используются как подсказка для нативной системы, поскольку базовая платформа может не поддерживать настройку местоположения и/или размера развёрнутых окон. В этом случае заданные значения не влияют на внешний вид рамки в развёрнутом состоянии.

Параметры:
bounds — границы для развёрнутого состояния
Начиная с:
1.4
См. также:
  • getMaximizedBounds()

getMaximizedBounds

public Rectangle getMaximizedBounds()
Возвращает границы развёрнутого состояния этой рамки. Некоторые поля могут содержать Integer.MAX_VALUE, указывая на то, что для этого поля необходимо использовать значения, заданные системой.
Возвращает:
границы развёрнутого состояния этой рамки; может быть null
Начиная с:
1.4
См. также:
  • setMaximizedBounds(Rectangle)

setUndecorated

public void setUndecorated(boolean undecorated)
Отключает или включает оформление этой рамки.

Этот метод можно вызывать только тогда, когда рамка не отображается. Чтобы рамка имела оформление, она должна быть непрозрачной и иметь форму по умолчанию; в противном случае будет выброшено исключение IllegalComponentStateException. Подробности см. в описаниях методов Window.setShape(Shape), Window.setOpacity(float) и Window.setBackground(Color).

Параметры:
undecorated — true, если оформление рамки следует отключить; false, если оформление рамки следует включить
Исключения:
IllegalComponentStateException — если рамка отображается
IllegalComponentStateException — если undecorated равно false и эта рамка не имеет формы по умолчанию
IllegalComponentStateException — если undecorated равно false и непрозрачность этой рамки меньше 1.0f
IllegalComponentStateException — если undecorated равно false и значение альфа-канала цвета фона этой рамки меньше 1.0f
Начиная с:
1.4
См. также:
  • isUndecorated()
  • Component.isDisplayable()
  • Window.getShape()
  • Window.getOpacity()
  • Window.getBackground()
  • JFrame.setDefaultLookAndFeelDecorated(boolean)

isUndecorated

public boolean isUndecorated()
Показывает, не имеет ли эта рамка оформления. По умолчанию все рамки изначально имеют оформление.
Возвращает:
true, если рамка не имеет оформления; в противном случае — false.
Начиная с:
1.4
См. также:
  • setUndecorated(boolean)

remove

public void remove(MenuComponent m)
Удаляет указанную строку меню из этого фрейма.
Указано в:
remove в интерфейсе MenuContainer
Переопределяет:
remove в классе Component
Параметры:
m — удаляемый компонент меню. Если m равно null, действие не выполняется
См. также:
  • Component.add(PopupMenu)

removeNotify

public void removeNotify()
Делает этот фрейм недоступным для отображения, удаляя его связь с собственным экранным ресурсом. Когда фрейм становится недоступным для отображения, все его дочерние элементы также становятся недоступными для отображения. Этот метод вызывается внутри инструментария и не должен вызываться программами напрямую.
Переопределяет:
removeNotify в классе Container
См. также:
  • Component.isDisplayable()
  • addNotify()

paramString

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

setCursor

@Deprecated public void setCursor(int cursorType)
Устарел.
Начиная с JDK версии 1.1 заменён на Component.setCursor(Cursor).
Устанавливает для этого фрейма указанный тип курсора.
Параметры:
cursorType — тип курсора

getCursorType

@Deprecated public int getCursorType()
Устарел.
Начиная с JDK версии 1.1 заменён на Component.getCursor().
Возвращает:
тип курсора для этого фрейма

getFrames

public static Frame[] getFrames()
Возвращает массив всех Frame, созданных этим приложением. При вызове из апплета массив включает только Frame, доступные этому апплету.

Предупреждение: этот метод может возвращать фреймы, созданные системой, например общий скрытый фрейм, используемый Swing. Приложения не должны предполагать существование этих фреймов и не должны делать предположений об их свойствах, таких как расположение компонентов, LayoutManager или сериализация.

Примечание: Чтобы получить список всех окон без владельца, включая Dialog без владельца (появившиеся в выпуске 1.6), используйте Window.getOwnerlessWindows.

Возвращает:
массив всех Frame, созданных этим приложением
Начиная с:
1.2
См. также:
  • Window.getWindows()
  • Window.getOwnerlessWindows()

getAccessibleContext

public AccessibleContext getAccessibleContext()
Получает AccessibleContext, связанный с этим Frame. Для фреймов AccessibleContext имеет вид AccessibleAWTFrame. При необходимости создаётся новый экземпляр AccessibleAWTFrame.
Указано в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Window
Возвращает:
AccessibleAWTFrame, выполняющий роль AccessibleContext этого Frame
Начиная с:
1.3

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по 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/java/awt/Frame.html

Spec-Zone.ru

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