Класс Frame
- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- java.awt.Window
-
- java.awt.Frame
- Все реализованные интерфейсы:
-
ImageObserver,MenuContainer,Serializable,Accessible
- Прямые известные подклассы:
JFrame
public class Frame extends Window implements MenuContainer
Класс Frame представляет собой окно верхнего уровня с заголовком и рамкой.
Размер фрейма включает в себя область, отведенную для рамки. Размеры области рамки можно получить с помощью метода getInsets, однако, так как эти размеры зависят от платформы, значение отступов не может быть получено до тех пор, пока фрейм не будет отображаться путём вызова pack или show. Поскольку область рамки включена в общий размер фрейма, рамка фактически скрывает часть фрейма, ограничивая область, доступную для отрисовки и/или отображения подкомпонентов, прямоугольником с верхним левым углом (insets.left, insets.top), и размером width - (insets.left + insets.right) на height - (insets.top + insets.bottom).
Стандартная компоновка для фрейма - BorderLayout.
Для фрейма можно отключить родные элементы управления (т.е. Frame и Titlebar) с помощью setUndecorated. Это можно сделать только пока фрейм не displayable.
В многоэкранной среде вы можете создать Frame на другом экране, создав Frame с помощью Frame(GraphicsConfiguration) или Frame(String title, GraphicsConfiguration). Объект GraphicsConfiguration является одним из объектов GraphicsConfiguration целевого устройства экрана.
В многоэкранной среде виртуального устройства, в которой область рабочего стола может охватывать несколько физических устройств экрана, границы всех конфигураций относительны к виртуальной системе координат. Начало виртуальной системы координат находится в верхнем левом углу основного физического экрана. В зависимости от расположения основного экрана на виртуальном устройстве возможны отрицательные координаты, как показано на рисунке ниже.
В такой среде при вызове setLocation, вы должны передать виртуальную координату этому методу. Аналогично, вызов getLocationOnScreen на Frame возвращает координаты виртуального устройства. Вызовите метод getBounds объекта GraphicsConfiguration для нахождения его начала координат в виртуальной системе координат.
Следующий код устанавливает расположение Frame в (10, 10) относительно начала координат физического экрана соответствующего GraphicsConfiguration. Если не учитывать границы GraphicsConfiguration, расположение Frame будет установлено в (10, 10) относительно виртуальной системы координат и отобразится на основном физическом экране, что может отличаться от физического экрана указанного GraphicsConfiguration.
Frame f = new Frame(GraphicsConfiguration gc);
Rectangle bounds = gc.getBounds();
f.setLocation(10 + bounds.x, 10 + bounds.y); Фреймы могут генерировать следующие типы событий:
-
WINDOW_OPENED -
WINDOW_CLOSING:
Если программа не скрывает или не удаляет окно явно во время обработки этого события, операция закрытия окна отменяется. -
WINDOW_CLOSED -
WINDOW_ICONIFIED -
WINDOW_DEICONIFIED -
WINDOW_ACTIVATED -
WINDOW_DEACTIVATED -
WINDOW_GAINED_FOCUS -
WINDOW_LOST_FOCUS -
WINDOW_STATE_CHANGED
- С:
- 1.0
- См. также:
-
WindowEvent,Window.addWindowListener(java.awt.event.WindowListener), Форматирование сериализованных данных
Вложенные классы
| Модификатор и тип | Класс | Описание |
|---|---|---|
protected class | Frame.AccessibleAWTFrame | Этот класс реализует поддержку доступности для класса |
Вложенные классы/интерфейсы, объявленные в классе java.awt.Window
Window.AccessibleAWTWindow, Window.Type Вложенные классы/интерфейсы, объявленные в классе java.awt.Container
Container.AccessibleAWTContainer Вложенные классы/интерфейсы, объявленные в классе java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy Поля
| Модификатор и тип | Поле | Описание |
|---|---|---|
static int | CROSSHAIR_CURSOR | Устарело. заменено на Cursor.CROSSHAIR_CURSOR. |
static int | DEFAULT_CURSOR | Устарело. заменено на Cursor.DEFAULT_CURSOR. |
static int | E_RESIZE_CURSOR | Устарело. заменено на Cursor.E_RESIZE_CURSOR. |
static int | HAND_CURSOR | Устарело. заменено на Cursor.HAND_CURSOR. |
static int | ICONIFIED | Этот флаг состояния указывает, что фрейм свернут. |
static int | MAXIMIZED_BOTH | Эта маска флага состояния указывает, что фрейм полностью максимизирован (то есть как по горизонтали, так и по вертикали). |
static int | MAXIMIZED_HORIZ | Этот флаг состояния указывает, что фрейм максимизирован по горизонтали. |
static int | MAXIMIZED_VERT | Этот флаг состояния указывает, что фрейм максимизирован по вертикали. |
static int | MOVE_CURSOR | Устарело. заменено на Cursor.MOVE_CURSOR. |
static int | N_RESIZE_CURSOR | Устарело. заменено на Cursor.N_RESIZE_CURSOR. |
static int | NE_RESIZE_CURSOR | Устарело. заменено на Cursor.NE_RESIZE_CURSOR. |
static int | NORMAL | Фрейм в «нормальном» состоянии. |
static int | NW_RESIZE_CURSOR | Устарело. заменено на Cursor.NW_RESIZE_CURSOR. |
static int | S_RESIZE_CURSOR | Устарело. заменено на Cursor.S_RESIZE_CURSOR. |
static int | SE_RESIZE_CURSOR | Устарело. заменено на Cursor.SE_RESIZE_CURSOR. |
static int | SW_RESIZE_CURSOR | Устарело. заменено на Cursor.SW_RESIZE_CURSOR. |
static int | TEXT_CURSOR | Устарело. заменено на Cursor.TEXT_CURSOR. |
static int | W_RESIZE_CURSOR | Устарело. заменено на Cursor.W_RESIZE_CURSOR. |
static int | WAIT_CURSOR | Устарело. заменено на Cursor.WAIT_CURSOR. |
Поля, объявленные в классе java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT Поля, объявленные в интерфейсе java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH Конструкторы
| Конструктор | Описание |
|---|---|
Frame() | Создает новый экземпляр |
Frame(GraphicsConfiguration gc) | Создаёт новое, изначально невидимое |
Frame(String title) | Создает новый, изначально невидимый объект |
Frame(String title,
GraphicsConfiguration gc) | Создаёт новый, изначально невидимый объект |
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
void | addNotify() | Делает этот Frame отображаемым, подключив его к ресурсу нативного экрана. |
AccessibleContext | getAccessibleContext() | Получает AccessibleContext, связанный с этим Frame. |
int | getCursorType() | Устарело. Начиная с версии JDK 1.1, заменено на Component.getCursor(). |
int | getExtendedState() | Получает состояние этого фрейма. |
static Frame[] | getFrames() | Возвращает массив всех |
Image | getIconImage() | Возвращает изображение, отображаемое в качестве значка для этого фрейма. |
Rectangle | getMaximizedBounds() | Получает максимальные границы для этого фрейма. |
MenuBar | getMenuBar() | Получает строку меню для этого фрейма. |
int | getState() | Получает состояние этого фрейма (устарело). |
String | getTitle() | Получает заголовок фрейма. |
boolean | isResizable() | Указывает, может ли пользователь изменять размер этого фрейма. |
boolean | isUndecorated() | Указывает, является ли этот фрейм без декораций. |
protected String | paramString() | Возвращает строку, представляющую состояние этого |
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
Окно находится в состоянии "нормально". Эта символическая константа задаёт состояние окна, где все биты состояния сброшены.
ИКОНИФИЦИРОВАНО
public static final int ICONIFIED
Этот бит состояния указывает, что окно свернуто.
МАКСИМИЗИРОВАНО_ГОРИЗОНТАЛЬНО
public static final int MAXIMIZED_HORIZ
Этот бит состояния указывает, что окно максимизировано по горизонтали.
- С:
- 1.4
- См. также:
-
setExtendedState(int),getExtendedState(), Значения константных полей
МАКСИМИЗИРОВАНО_ВЕРТИКАЛЬНО
public static final int MAXIMIZED_VERT
Этот бит состояния указывает, что окно максимизировано по вертикали.
- С:
- 1.4
- См. также:
-
setExtendedState(int),getExtendedState(), Значения константных полей
МАКСИМИЗИРОВАНО_ПОЛНОСТЬЮ
public static final int MAXIMIZED_BOTH
Эта маска бита состояния указывает, что окно полностью максимизировано (то есть и по горизонтали, и по вертикали). Это просто псевдоним для MAXIMIZED_VERT | MAXIMIZED_HORIZ.
Обратите внимание, что правильная проверка того, что окно полностью максимизировано, выполняется следующим образом:
(state & Frame.MAXIMIZED_BOTH) == Frame.MAXIMIZED_BOTH
Чтобы проверить, что окно максимизировано хотя бы в каком-то направлении, используйте
(state & Frame.MAXIMIZED_BOTH) != 0
- С:
- 1.4
- См. также:
-
setExtendedState(int),getExtendedState(), Значения константных полей
Конструкторы
Frame
public Frame()
throws HeadlessException Создаёт новый экземпляр Frame, который изначально невидим. Заголовок Frame пустой.
- Выбрасывает:
-
HeadlessException- когдаGraphicsEnvironment.isHeadless()возвращаетtrue - См. также:
-
GraphicsEnvironment.isHeadless(),Component.setSize(int, int),Component.setVisible(boolean)
Frame
public Frame(GraphicsConfiguration gc)
Создаёт новое, изначально невидимое Frame с заданной GraphicsConfiguration.
- Параметры:
-
gc-GraphicsConfigurationцелевого устройства экрана. Еслиgc-null, используется системный параметрGraphicsConfiguration. - Выбрасывает:
-
IllegalArgumentException- еслиgcне с устройства экрана. -
HeadlessException- когдаGraphicsEnvironment.isHeadless()возвращаетtrue - С:
- 1.3
- См. также:
GraphicsEnvironment.isHeadless()
Frame
public Frame(String title)
throws HeadlessException Создаёт новый, изначально невидимый объект Frame с указанным заголовком.
- Параметры:
-
title- заголовок, который будет отображаться в рамке. Значениеnullобрабатывается как пустая строка, "". - Выбрасывает:
-
HeadlessException- когдаGraphicsEnvironment.isHeadless()возвращаетtrue - См. также:
-
GraphicsEnvironment.isHeadless(),Component.setSize(int, int),Component.setVisible(boolean),GraphicsConfiguration.getBounds()
Frame
public Frame(String title,
GraphicsConfiguration gc) Создаёт новый, изначально невидимый объект Frame с указанным заголовком и GraphicsConfiguration.
- Параметры:
-
title- заголовок, который будет отображаться в рамке. Значениеnullобрабатывается как пустая строка, "". -
gc-GraphicsConfigurationцелевого устройства экрана. Еслиgc-null, используется системный параметрGraphicsConfiguration. - Выбрасывает:
-
IllegalArgumentException- еслиgcне с устройства экрана. -
HeadlessException- когдаGraphicsEnvironment.isHeadless()возвращаетtrue - С:
- 1.3
- См. также:
-
GraphicsEnvironment.isHeadless(),Component.setSize(int, int),Component.setVisible(boolean),GraphicsConfiguration.getBounds()
Методы
addNotify
public void addNotify()
Делает этот Frame отображаемым, подключив его к нативному ресурсу экрана. Делая фрейм отображаемым, вы делаете отображаемыми и все его дочерние элементы. Этот метод вызывается внутри инструментария и не должен вызываться программами напрямую.
- Переопределяет:
-
addNotifyв классеWindow - См. также:
-
Component.isDisplayable(),removeNotify()
getTitle
public String getTitle()
Получает заголовок фрейма. Заголовок отображается в рамке фрейма.
- Возвращает:
- заголовок этого фрейма или пустую строку ("") если у этого фрейма нет заголовка.
- См. также:
setTitle(String)
setTitle
public void setTitle(String title)
Устанавливает заголовок для этого фрейма, задав указанную строку.
- Параметры:
-
title- заголовок, который должен быть отображен в рамке фрейма. Значениеnullобрабатывается как пустая строка, "". - См. также:
getTitle()
getIconImage
public Image getIconImage()
Возвращает изображение, которое должно быть отображено как значок для этого фрейма.
Этот метод устарел и сохраняется только для обратной совместимости. Используйте Window.getIconImages() вместо него.
Если в качестве значка окна было указано несколько изображений, этот метод вернёт первый элемент списка.
- Возвращает:
- изображение значка для этого фрейма или
null, если у этого фрейма нет изображения значка. - См. также:
-
Window.setIconImage(Image),Window.getIconImages(),Window.setIconImages(java.util.List<? extends java.awt.Image>)
getMenuBar
public MenuBar getMenuBar()
Получает строку меню для этого фрейма.
- Возвращает:
- строку меню для этого фрейма или
nullесли у этого фрейма нет строки меню. - См. также:
setMenuBar(MenuBar)
setMenuBar
public void setMenuBar(MenuBar mb)
Устанавливает строку меню для этого фрейма, задав указанную строку меню.
- Параметры:
-
mb- устанавливаемая строка меню. Если этот параметрnull, то любая существующая строка меню в этом фрейме удаляется. - См. также:
getMenuBar()
isResizable
public boolean isResizable()
Указывает, может ли пользователь изменять размеры этого фрейма. По умолчанию все фреймы изначально могут быть изменены в размерах.
- Возвращает:
-
true, если пользователь может изменить размер этого фрейма;falseв противном случае. - См. также:
setResizable(boolean)
setResizable
public void setResizable(boolean resizable)
Устанавливает, может ли пользователь изменять размеры этого фрейма.
- Параметры:
-
resizable-true, если этот фрейм может быть изменен в размерах;falseв противном случае. - См. также:
isResizable()
setState
public void setState(int state)
Устанавливает состояние этого фрейма (устарело).
В более ранних версиях JDK состояние фрейма могло быть только NORMAL или ICONIFIED. Начиная с JDK 1.4 набор поддерживаемых состояний фрейма расширен, и состояние фрейма представлено как побитовая маска.
Для совместимости с приложениями, разработанными ранее, этот метод по-прежнему принимает Frame.NORMAL и Frame.ICONIFIED только. Состояние значка фрейма изменяется только, другие аспекты состояния фрейма не затрагиваются этим методом. Если переданное состояние не является ни
Frame.NORMAL , ни Frame.ICONIFIED , метод вообще не выполняет никаких действий.
Обратите внимание, что если состояние не поддерживается на данной платформе, ни состояние, ни возвращаемое значение метода getState() не будут изменены. Приложение может определить, поддерживается ли конкретное состояние с помощью метода Toolkit.isFrameStateSupported(int).
Если фрейм в данный момент отображается на экране (метод Window.isShowing() возвращает true), разработчик должен проверить возвращаемое значение метода WindowEvent.getNewState() объекта WindowEvent , полученного через WindowStateListener , чтобы определить, действительно ли состояние было изменено.
Если фрейм не отображается на экране, события могут или не могут быть сгенерированы. В этом случае разработчик может предположить, что состояние изменяется сразу после возврата этого метода. Позже, когда вызывается метод
setVisible(true) , фрейм попытается применить это состояние. Получение любых событий WindowEvent.WINDOW_STATE_CHANGED в этом случае также не гарантируется.
- Параметры:
-
state- либоFrame.NORMAL, либоFrame.ICONIFIED. - См. также:
-
setExtendedState(int),Window.addWindowStateListener(java.awt.event.WindowStateListener)
setExtendedState
public void setExtendedState(int state)
Устанавливает состояние этого фрейма. Состояние представлено как побитовая маска.
-
NORMAL
Указывает, что биты состояния не установлены. -
ICONIFIED -
MAXIMIZED_HORIZ -
MAXIMIZED_VERT -
MAXIMIZED_BOTH
ОбъединяетMAXIMIZED_HORIZиMAXIMIZED_VERT.
Обратите внимание, что если состояние не поддерживается на данной платформе, ни состояние, ни возвращаемое значение метода getExtendedState() не будут изменены. Приложение может определить, поддерживается ли конкретное состояние с помощью метода Toolkit.isFrameStateSupported(int).
Если фрейм в данный момент отображается на экране (метод Window.isShowing() возвращает true), разработчик должен проверить возвращаемое значение метода WindowEvent.getNewState() объекта WindowEvent , полученного через WindowStateListener , чтобы определить, действительно ли состояние было изменено.
Если фрейм не отображается на экране, события могут или не могут быть сгенерированы. В этом случае разработчик может предположить, что состояние изменяется сразу после возврата этого метода. Позже, когда вызывается метод
setVisible(true) , фрейм попытается применить это состояние. Получение любых событий WindowEvent.WINDOW_STATE_CHANGED в этом случае также не гарантируется.
- Параметры:
-
state- побитовая маска констант состояния фрейма - С:
- 1.4
- См. также:
Window.addWindowStateListener(java.awt.event.WindowStateListener)
getState
public int getState()
Получает состояние этого фрейма (устарело).
В более ранних версиях JDK состояние фрейма могло быть только NORMAL или ICONIFIED. Начиная с JDK 1.4 набор поддерживаемых состояний фрейма расширен, и состояние фрейма представлено как побитовая маска.
Для совместимости со старыми программами этот метод по-прежнему возвращает Frame.NORMAL и Frame.ICONIFIED , но он сообщает только о состоянии значка фрейма, другие аспекты состояния фрейма этим методом не отображаются.
- Возвращает:
-
Frame.NORMALилиFrame.ICONIFIED. - См. также:
-
setState(int),getExtendedState()
getExtendedState
public int getExtendedState()
Получает состояние этого фрейма. Состояние представлено как побитовая маска.
-
NORMAL
Указывает, что биты состояния не установлены. -
ICONIFIED -
MAXIMIZED_HORIZ -
MAXIMIZED_VERT -
MAXIMIZED_BOTH
ОбъединяетMAXIMIZED_HORIZиMAXIMIZED_VERT.
- Возвращает:
- побитовая маска констант состояния фрейма
- С:
- 1.4
- См. также:
setExtendedState(int)
setMaximizedBounds
public void setMaximizedBounds(Rectangle bounds)
Устанавливает границы максимального размера для этого фрейма.
Когда фрейм находится в состоянии максимального размера, система предоставляет некоторые значения по умолчанию. Этот метод позволяет переопределить некоторые или все эти значения, предоставленные системой.
Если bounds равно null, принимаются границы, предоставленные системой. Если не null, вы можете переопределить некоторые из предоставленных системой значений, принимая другие, установив нужные поля, которые вы хотите принять от системы, в Integer.MAX_VALUE.
Обратите внимание, что заданные границы максимального размера используются как подсказка для нативной системы, поскольку платформа ниже может не поддерживать установку расположения и/или размера окон в режиме максимального размера. Если это так, предоставленные значения не влияют на вид фрейма в режиме максимального размера.
- Параметры:
-
bounds- границы для состояния максимального размера - С:
- 1.4
- См. также:
getMaximizedBounds()
getMaximizedBounds
public Rectangle getMaximizedBounds()
Получает границы максимального размера для этого фрейма. Некоторые поля могут содержать Integer.MAX_VALUE , чтобы указать, что необходимо использовать значения, предоставленные системой для этого поля.
- Возвращает:
- границы максимального размера для этого фрейма; может быть
null - С:
- 1.4
- См. также:
setMaximizedBounds(Rectangle)
setUndecorated
public void setUndecorated(boolean undecorated)
Отключает или включает украшения для этого фрейма.
Этот метод может быть вызван только, когда фрейм не отображается. Чтобы сделать этот фрейм украшенным, он должен быть непрозрачным и иметь стандартную форму, иначе будет выброшено исключение IllegalComponentStateException. Обратитесь к Window.setShape(java.awt.Shape), Window.setOpacity(float) и Window.setBackground(java.awt.Color) для получения подробностей
- Параметры:
-
undecorated-trueесли декорации рамки не должны быть включены;falseесли декорации рамки должны быть включены - Исключения:
-
IllegalComponentStateException- если рамка отображается -
IllegalComponentStateException- еслиundecoratedявляетсяfalse, и у этой рамки нет стандартной формы -
IllegalComponentStateException- еслиundecoratedявляетсяfalse, и непрозрачность этой рамки меньше1.0f -
IllegalComponentStateException- еслиundecoratedявляетсяfalse, и значение альфа-канала цвета фона этой рамки меньше1.0f - С тех пор:
- 1.4
- См. также:
-
isUndecorated(),Component.isDisplayable(),Window.getShape(),Window.getOpacity(),Window.getBackground(),JFrame.setDefaultLookAndFeelDecorated(boolean)
isUndecorated
public boolean isUndecorated()
Указывает, является ли эта рамка без декораций. По умолчанию все рамки изначально имеют декорации.
- Возвращает:
-
trueесли рамка без декораций;falseв противном случае. - С тех пор:
- 1.4
- См. также:
setUndecorated(boolean)
remove
public void remove(MenuComponent m)
Удаляет указанную строку меню из этой рамки.
- Определено в:
-
removeв интерфейсеMenuContainer - Переопределяет:
-
removeв классеComponent - Параметры:
-
m- компонент меню для удаления. Еслиmявляетсяnull, никаких действий не выполняется - См. также:
Component.add(PopupMenu)
removeNotify
public void removeNotify()
Делает эту рамку недоступной для отображения, удаляя ее подключение к ресурсам экрана. Делание рамки недоступной для отображения приведет к тому, что все ее дочерние элементы будут сделаны недоступными для отображения. Этот метод вызывается внутри инструментария и не должен вызываться программами напрямую.
- Переопределяет:
-
removeNotifyв классеContainer - См. также:
-
Component.isDisplayable(),addNotify()
paramString
protected String paramString()
Возвращает строку, представляющую состояние этой Frame. Этот метод предназначен только для отладки, и содержимое и формат возвращаемой строки могут различаться между реализациями. Возвращаемая строка может быть пустой, но не null.
- Переопределяет:
-
paramStringв классеContainer - Возвращает:
- строку параметров этой рамки
setCursor
@Deprecated public void setCursor(int cursorType)
Component.setCursor(Cursor).Устанавливает курсор для этой рамки на указанный тип.
- Параметры:
-
cursorType- тип курсора
getCursorType
@Deprecated public int getCursorType()
Component.getCursor().- Возвращает:
- тип курсора для этой рамки
getFrames
public static Frame[] getFrames()
Возвращает массив всех Frame созданных этим приложением. Если вызывается из аплета, массив включает только Frame доступные этому апплету.
Предупреждение: этот метод может возвращать созданные системой рамки, такие как общая, скрытая рамка, используемая Swing. Приложения не должны полагаться на существование этих рамок, и приложение не должно делать никаких предположений об этих рамках, таких как положение компонентов, LayoutManager или сериализация.
Примечание: Чтобы получить список всех окон без владельца, включая окна без владельца Dialog (введенные в релизе 1.6), используйте Window.getOwnerlessWindows.
- Возвращает:
- массив всех
Frameсозданных этим приложением - С тех пор:
- 1.2
- См. также:
-
Window.getWindows(),Window.getOwnerlessWindows()
getAccessibleContext
public AccessibleContext getAccessibleContext()
Получает AccessibleContext, связанный с этой рамкой. Для рамок AccessibleContext принимает форму AccessibleAWTFrame. Если необходимо, создается новый экземпляр AccessibleAWTFrame.
- Определено в:
-
getAccessibleContextв интерфейсеAccessible - Переопределяет:
-
getAccessibleContextв классеWindow - Возвращает:
- AccessibleAWTFrame, который служит AccessibleContext этой рамки
- С тех пор:
- 1.3
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/java/awt/Frame.html