Spec-Zone.ru › OpenJDK 17

Класс Frame

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

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

Следующий код устанавливает положение фрейма в (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.
См. также:
  • 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)

Фрейм

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

Фрейм

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

Фрейм

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()
Делает этот Frame недоступным для отображения, удалив его соединение с его родным ресурсом экрана. Делание Frame недоступным для отображения приведет к тому, что все его дочерние элементы станут недоступны для отображения. Этот метод вызывается инструментом внутри и не должен вызываться непосредственно программами.
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, связанный с этим Frame. Для фреймов AccessibleContext принимает форму AccessibleAWTFrame. Новый экземпляр AccessibleAWTFrame создается при необходимости.
Указано:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Window
Возвращает:
AccessibleAWTFrame, который служит AccessibleContext этого Frame
С:
1.3

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

Spec-Zone.ru

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