Spec-Zone.ru › OpenJDK 24

Класс Фрейм

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
Фрейм — это окно верхнего уровня с заголовком и рамкой.

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

По умолчанию для фрейма используется компоновщик BorderLayout.

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

В многоэкранной среде вы можете создать фрейм на другом экране, создав фрейм с помощью 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 на фрейме возвращает координаты виртуального устройства. Вызовите метод getBounds фрейма, чтобы найти его начало в виртуальной системе координат.

Следующий код устанавливает положение фрейма в (10, 10) относительно начала физического экрана соответствующего GraphicsConfiguration. Если не учитывать границы GraphicsConfiguration, положение фрейма было бы установлено в (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 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.

Поля, объявленные в классе 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()
Возвращает массив всех 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)
Отключает или включает декорации для этого фрейма.

Методы, объявленные в классе 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.
См. также:
  • Constant Field Values

CROSSHAIR_CURSOR

@Deprecated public static final int CROSSHAIR_CURSOR
Устарело.
заменено на Cursor.CROSSHAIR_CURSOR.
См. также:
  • Constant Field Values

TEXT_CURSOR

@Deprecated public static final int TEXT_CURSOR
Устарело.
заменено на Cursor.TEXT_CURSOR.
См. также:
  • Constant Field Values

WAIT_CURSOR

@Deprecated public static final int WAIT_CURSOR
Устарело.
заменено на Cursor.WAIT_CURSOR.
См. также:
  • Constant Field Values

SW_RESIZE_CURSOR

@Deprecated public static final int SW_RESIZE_CURSOR
Устарело.
заменено на Cursor.SW_RESIZE_CURSOR.
См. также:
  • Constant Field Values

SE_RESIZE_CURSOR

@Deprecated public static final int SE_RESIZE_CURSOR
Устарело.
заменено на Cursor.SE_RESIZE_CURSOR.
См. также:
  • Constant Field Values

NW_RESIZE_CURSOR

@Deprecated public static final int NW_RESIZE_CURSOR
Устарело.
заменено на Cursor.NW_RESIZE_CURSOR.
См. также:
  • Constant Field Values

NE_RESIZE_CURSOR

@Deprecated public static final int NE_RESIZE_CURSOR
Устарело.
заменено на Cursor.NE_RESIZE_CURSOR.
См. также:
  • Constant Field Values

N_RESIZE_CURSOR

@Deprecated public static final int N_RESIZE_CURSOR
Устарело.
заменено на Cursor.N_RESIZE_CURSOR.
См. также:
  • Constant Field Values

S_RESIZE_CURSOR

@Deprecated public static final int S_RESIZE_CURSOR
Устарело.
заменено на Cursor.S_RESIZE_CURSOR.
См. также:
  • Constant Field Values

W_RESIZE_CURSOR

@Deprecated public static final int W_RESIZE_CURSOR
Устарело.
заменено на Cursor.W_RESIZE_CURSOR.
См. также:
  • Constant Field Values

E_RESIZE_CURSOR

@Deprecated public static final int E_RESIZE_CURSOR
Устарело.
заменено на Cursor.E_RESIZE_CURSOR.
См. также:
  • Constant Field Values

HAND_CURSOR

@Deprecated public static final int HAND_CURSOR
Устарело.
заменено на Cursor.HAND_CURSOR.
См. также:
  • Constant Field Values

MOVE_CURSOR

@Deprecated public static final int MOVE_CURSOR
Устарело.
заменено на Cursor.MOVE_CURSOR.
См. также:
  • Constant Field Values

NORMAL

public static final int NORMAL
Фрейм находится в "нормальном" состоянии. Эта символическая константа обозначает состояние фрейма со всеми сброшенными битами состояния.
См. также:
  • setExtendedState(int)
  • getExtendedState()
  • Constant Field Values

ICONIFIED

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

MAXIMIZED_HORIZ

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

MAXIMIZED_VERT

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

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()
  • Constant Field Values

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

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 в этом случае не гарантируется.

Parameters:
state - побитовая маска констант состояния фрейма
Since:
1.4
See Also:
  • Window.addWindowStateListener(java.awt.event.WindowStateListener)

getState

public int getState()
Получает состояние этого фрейма (устарело).

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

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

Returns:
Frame.NORMAL или Frame.ICONIFIED.
See Also:
  • setState(int)
  • getExtendedState()

getExtendedState

public int getExtendedState()
Получает состояние этого фрейма. Состояние представлено как побитовая маска.
  • NORMAL
    Указывает, что биты состояния не установлены.
  • ICONIFIED
  • MAXIMIZED_HORIZ
  • MAXIMIZED_VERT
  • MAXIMIZED_BOTH
    Объединяет MAXIMIZED_HORIZ и MAXIMIZED_VERT.
Returns:
побитовая маска констант состояния фрейма
Since:
1.4
See Also:
  • setExtendedState(int)

setMaximizedBounds

public void setMaximizedBounds(Rectangle bounds)
Устанавливает пределы максимального размера для этого фрейма.

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

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

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

Parameters:
bounds - пределы максимального размера
Since:
1.4
See Also:
  • getMaximizedBounds()

getMaximizedBounds

public Rectangle getMaximizedBounds()
Получает пределы максимального размера для этого фрейма. Некоторые поля могут содержать Integer.MAX_VALUE, чтобы указать, что необходимо использовать значения, заданные системой для этого поля.
Returns:
пределы максимального размера для этого фрейма; может быть null
Since:
1.4
See Also:
  • setMaximizedBounds(Rectangle)

setUndecorated

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

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

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

isUndecorated

public boolean isUndecorated()
Указывает, является ли этот фрейм без декораций. По умолчанию все фреймы изначально имеют декорации.
Returns:
true, если фрейм без декораций; false в противном случае.
Since:
1.4
See Also:
  • setUndecorated(boolean)

remove

public void remove(MenuComponent m)
Удаляет заданную панель меню из этого фрейма.
Specified by:
remove в интерфейсе MenuContainer
Overrides:
remove в классе Component
Parameters:
m - компонент меню для удаления. Если m равно null, то никаких действий не производится
See Also:
  • Component.add(PopupMenu)

removeNotify

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

paramString

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

setCursor

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

getCursorType

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

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, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/Frame.html

Spec-Zone.ru

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