Класс Frame

Все реализованные интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible
Прямые известные подклассы:
JFrame
public class Frame
extends Window
implements MenuContainer

Класс Frame представляет собой окно верхнего уровня с заголовком и рамкой.

Размер фрейма включает в себя область, отведенную для рамки. Размеры области рамки можно получить с помощью метода getInsets, однако, так как эти размеры зависят от платформы, значение отступов не может быть получено до тех пор, пока фрейм не будет отображаться путём вызова 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);

Фреймы могут генерировать следующие типы событий:

  • 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(java.awt.event.WindowListener), Форматирование сериализованных данных

Вложенные классы

Модификатор и тип Класс Описание
protected class  Frame.AccessibleAWTFrame

Этот класс реализует поддержку доступности для класса Frame.

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

Window.AccessibleAWTWindow, Window.Type

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

Container.AccessibleAWTContainer

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

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

Поля

Модификатор и тип Поле Описание
static int CROSSHAIR_CURSOR

Устарело.

заменено на Cursor.CROSSHAIR_CURSOR.

static int DEFAULT_CURSOR

Устарело.

заменено на Cursor.DEFAULT_CURSOR.

static int E_RESIZE_CURSOR

Устарело.

заменено на Cursor.E_RESIZE_CURSOR.

static int HAND_CURSOR

Устарело.

заменено на Cursor.HAND_CURSOR.

static int ICONIFIED

Этот флаг состояния указывает, что фрейм свернут.

static int MAXIMIZED_BOTH

Эта маска флага состояния указывает, что фрейм полностью максимизирован (то есть как по горизонтали, так и по вертикали).

static int MAXIMIZED_HORIZ

Этот флаг состояния указывает, что фрейм максимизирован по горизонтали.

static int MAXIMIZED_VERT

Этот флаг состояния указывает, что фрейм максимизирован по вертикали.

static int MOVE_CURSOR

Устарело.

заменено на Cursor.MOVE_CURSOR.

static int N_RESIZE_CURSOR

Устарело.

заменено на Cursor.N_RESIZE_CURSOR.

static int NE_RESIZE_CURSOR

Устарело.

заменено на Cursor.NE_RESIZE_CURSOR.

static int NORMAL

Фрейм в «нормальном» состоянии.

static int NW_RESIZE_CURSOR

Устарело.

заменено на Cursor.NW_RESIZE_CURSOR.

static int S_RESIZE_CURSOR

Устарело.

заменено на Cursor.S_RESIZE_CURSOR.

static int SE_RESIZE_CURSOR

Устарело.

заменено на Cursor.SE_RESIZE_CURSOR.

static int SW_RESIZE_CURSOR

Устарело.

заменено на Cursor.SW_RESIZE_CURSOR.

static int TEXT_CURSOR

Устарело.

заменено на Cursor.TEXT_CURSOR.

static int W_RESIZE_CURSOR

Устарело.

заменено на Cursor.W_RESIZE_CURSOR.

static int WAIT_CURSOR

Устарело.

заменено на Cursor.WAIT_CURSOR.

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

Возвращает массив всех Frames, созданных этим приложением.

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)

Отключает или включает декорации для этого фрейма.

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

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

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

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

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

Методы, объявленные в интерфейсе java.awt.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(), Значения константных полей

ИКОНИФИЦИРОВАНО

public static final int ICONIFIED

Этот бит состояния указывает, что окно свернуто.

См. также:
setExtendedState(int), getExtendedState(), Значения константных полей

МАКСИМИЗИРОВАНО_ГОРИЗОНТАЛЬНО

public static final int MAXIMIZED_HORIZ

Этот бит состояния указывает, что окно максимизировано по горизонтали.

С:
1.4
См. также:
setExtendedState(int), getExtendedState(), Значения константных полей

МАКСИМИЗИРОВАНО_ВЕРТИКАЛЬНО

public static final int MAXIMIZED_VERT

Этот бит состояния указывает, что окно максимизировано по вертикали.

С:
1.4
См. также:
setExtendedState(int), getExtendedState(), Значения константных полей

МАКСИМИЗИРОВАНО_ПОЛНОСТЬЮ

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()

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

Переопределяет:
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(java.util.List<? extends java.awt.Image>)

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(java.awt.event.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(java.awt.event.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(java.awt.Shape), Window.setOpacity(float) и Window.setBackground(java.awt.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, связанный с этой рамкой. Для рамок AccessibleContext принимает форму AccessibleAWTFrame. Если необходимо, создается новый экземпляр AccessibleAWTFrame.

Определено в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Window
Возвращает:
AccessibleAWTFrame, который служит AccessibleContext этой рамки
С тех пор:
1.3

© 1993, 2020, 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/11/docs/api/java.desktop/java/awt/Frame.html

Spec-Zone .ru
спецификации, руководства, описания, API