Spec-Zone.ru › OpenJDK 21

Класс Фрейм

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, однако, поскольку эти размеры зависят от платформы, значение отступов не может быть получено, пока фрейм не станет отображаемым, вызвав либо 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 на 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)
  • Сериализованная форма

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

Modifier and Type Class Description
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

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

Modifier and Type Field Description
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

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

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

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

Modifier and Type Method Description
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.
См. также:
  • Значения константных полей

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.
Parameters:
gc - GraphicsConfiguration целевого устройства экрана. Если gc равно null, используется системный GraphicsConfiguration по умолчанию.
Throws:
IllegalArgumentException - если gc не относится к устройству экрана.
HeadlessException - когда GraphicsEnvironment.isHeadless() возвращает true
Since:
1.3
See Also:
  • GraphicsEnvironment.isHeadless()

Frame

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

Frame

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

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

addNotify

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

getTitle

public String getTitle()
Получает заголовок фрейма. Заголовок отображается в рамке фрейма.
Returns:
заголовок этого фрейма или пустая строка ("") если у этого фрейма нет заголовка.
See Also:
  • setTitle(String)

setTitle

public void setTitle(String title)
Устанавливает заголовок этого фрейма на указанную строку.
Parameters:
title - заголовок, который будет отображаться в рамке фрейма. Значение null обрабатывается как пустая строка, "".
See Also:
  • getTitle()

getIconImage

public Image getIconImage()
Возвращает изображение, которое будет отображаться в качестве значка для этого фрейма.

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

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

Returns:
изображение значка для этого фрейма или null если у этого фрейма нет изображения значка.
See Also:
  • Window.setIconImage(Image)
  • Window.getIconImages()
  • Window.setIconImages(java.util.List<? extends java.awt.Image>)

getMenuBar

public MenuBar getMenuBar()
Получает строку меню для этого фрейма.
Returns:
строку меню для этого фрейма или null если у этого фрейма нет строки меню.
See Also:
  • setMenuBar(MenuBar)

setMenuBar

public void setMenuBar(MenuBar mb)
Устанавливает строку меню для этого фрейма на указанную строку меню.
Parameters:
mb - устанавливаемая строка меню. Если этот параметр null, любая существующая строка меню этого фрейма удаляется.
See Also:
  • getMenuBar()

isResizable

public boolean isResizable()
Указывает, можно ли пользователю изменять размер этого фрейма. По умолчанию все фреймы изначально изменяемы по размеру.
Returns:
true если пользователь может изменить размер этого фрейма; false в противном случае.
See Also:
  • setResizable(boolean)

setResizable

public void setResizable(boolean resizable)
Устанавливает, можно ли пользователю изменять размер этого фрейма.
Parameters:
resizable - true если этот фрейм изменяемый по размеру; false в противном случае.
See Also:
  • 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 в этом случае также не гарантируется.

Parameters:
state - либо Frame.NORMAL, либо Frame.ICONIFIED.
See Also:
  • setExtendedState(int)
  • Window.addWindowStateListener(java.awt.event.WindowStateListener)

setExtendedState

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

Обратите внимание, что если состояние не поддерживается на данной платформе, ни состояние, ни возвращаемое значение метода 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, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/awt/Frame.html

Spec-Zone.ru

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