Класс Frame

Окно Frame — это окно верхнего уровня с заголовком и рамкой.

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

Рамки могут генерировать следующие типы WindowEvent:

• WINDOW_OPENED
• WINDOW_CLOSING:
  Если программа не скрывает или не удаляет окно явно при обработке этого события, операция закрытия окна отменяется.
• WINDOW_CLOSED
• WINDOW_ICONIFIED
• WINDOW_DEICONIFIED
• WINDOW_ACTIVATED
• WINDOW_DEACTIVATED
• WINDOW_GAINED_FOCUS
• WINDOW_LOST_FOCUS
• WINDOW_STATE_CHANGED

Поля

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.

См. также:

Значения константных полей

НОРМАЛЬНЫЙ

public static final int NORMAL

Фрейм находится в состоянии "нормально". Этот символьный констант задаёт состояние фрейма со сброшенными битами состояния.

См. также:

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

МИНИМИЗИРОВАННЫЙ

public static final int ICONIFIED

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

См. также:

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

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

public static final int MAXIMIZED_HORIZ

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

C тех пор:

1.4

См. также:

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

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

public static final int MAXIMIZED_VERT

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

C тех пор:

1.4

См. также:

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

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

public static final int MAXIMIZED_BOTH

(state & Frame.MAXIMIZED_BOTH) == Frame.MAXIMIZED_BOTH

(state & Frame.MAXIMIZED_BOTH) != 0

C тех пор:

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

C тех пор:

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

C тех пор:

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

Возвращает:

изображение значка для этой рамки или null , если у этой рамки нет изображения значка.

См. также:

setIconImage(Image), Window.getIconImages(), Window.setIconImages(java.util.List<? extends java.awt.Image>)

setIconImage

public void setIconImage(Image image)

setIconImage(image);

ArrayList<Image> imageList = new ArrayList<Image>();
     imageList.add(image);
     setIconImages(imageList);

Переопределяет:

setIconImage в классе Window

Параметры:

image - изображение значка, которое должно отображаться.

См. также:

Window.setIconImages(java.util.List<? extends java.awt.Image>), Window.getIconImages()

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)

Параметры:

state - либо Frame.NORMAL , либо Frame.ICONIFIED.

См. также:

setExtendedState(int), Window.addWindowStateListener(java.awt.event.WindowStateListener)

setExtendedState

public void setExtendedState(int state)

Параметры:

state - битовая маска констант состояния рамки

С:

1.4

См. также:

Window.addWindowStateListener(java.awt.event.WindowStateListener)

getState

public int getState()

Возвращает:

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 - границы для максимального состояния

С:

1.4

См. также:

getMaximizedBounds()

getMaximizedBounds

public Rectangle getMaximizedBounds()

Получает максимальные границы для этой рамки. Некоторые поля могут содержать Integer.MAX_VALUE , чтобы указать, что для этого поля должны использоваться значения, предоставленные системой.

Возвращает:

максимальные границы для этой рамки; может быть null

С:

1.4

См. также:

setMaximizedBounds(Rectangle)

setUndecorated

public void setUndecorated(boolean undecorated)

Параметры:

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)

setOpacity

public void setOpacity(float opacity)

Переопределяет:

setOpacity в классе Window

Параметры:

opacity - уровень непрозрачности, который необходимо установить для окна

См. также:

Window.getOpacity(), Window.setBackground(Color), Window.setShape(Shape), isUndecorated(), Dialog.isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)

setShape

public void setShape(Shape shape)

Переопределяет:

setShape в классе Window

Параметры:

shape - форма, которую необходимо установить для окна

См. также:

Window.getShape(), Window.setBackground(Color), Window.setOpacity(float), isUndecorated(), Dialog.isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)

setBackground

public void setBackground(Color bgColor)

Переопределяет:

setBackground в классе Window

Параметры:

bgColor - цвет, который должен стать цветом фона этого окна.

См. также:

Window.getBackground(), Window.isOpaque(), Window.setOpacity(float), Window.setShape(Shape), isUndecorated(), Dialog.isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency), GraphicsConfiguration.isTranslucencyCapable()

remove

public void remove(MenuComponent m)

Удаляет заданную панель меню из этой рамки.

Определено в:

remove в интерфейсе MenuContainer

Переопределяет:

remove в классе Component

Параметры:

m - компонент меню, который нужно удалить. Если m равно null, никаких действий не выполняется

См. также:

Component.add(PopupMenu)

removeNotify

public void removeNotify()

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

Переопределяет:

removeNotify в классе Window

См. также:

Component.isDisplayable(), addNotify()

paramString

protected String paramString()

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

Переопределяет:

paramString в классе Container

Возвращает:

строку параметров этого фрейма

setCursor

@Deprecated
public void setCursor(int cursorType)

Устарело. Начиная с версии JDK 1.1, заменено на Component.setCursor(Cursor).

getCursorType

@Deprecated
public int getCursorType()

Устарело. Начиная с версии JDK 1.1, заменено на Component.getCursor().

getFrames

public static Frame[] getFrames()

С:

1.2

См. также:

Window.getWindows(), Window.getOwnerlessWindows()

getAccessibleContext

public AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим Frame. Для фреймов AccessibleContext принимает вид AccessibleAWTFrame. Новый экземпляр AccessibleAWTFrame создается при необходимости.

Установлено:

getAccessibleContext в интерфейсе Accessible

Переопределяет:

getAccessibleContext в классе Window

Возвращает:

AccessibleAWTFrame, который служит AccessibleContext этого Frame

С:

1.3