Класс JWindow

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

javax.swing.JWindow

Все реализованные интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer

@JavaBean(defaultProperty="accessibleContext", description="A toplevel window which has no system border or controls.") public class JWindow extends Window implements Accessible, RootPaneContainer

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

Компонент JWindow содержит компонент JRootPane в качестве единственного дочернего элемента. Компонент contentPane должен быть родителем всех дочерних элементов JWindow. Для удобства методы add, remove и setLayout этого класса переопределены таким образом, что они делегируют вызовы соответствующим методам ContentPane. Например, вы можете добавить дочерний компонент в окно следующим образом:

       window.add(child);

А дочерний элемент будет добавлен в contentPane. contentPane всегда будет не-null. Попытка установить его в null приведёт к тому, что JWindow выбросит исключение. По умолчанию contentPane будет иметь установленный менеджер BorderLayout. Обратитесь к RootPaneContainer для получения подробной информации об добавлении, удалении и установке LayoutManager JWindow.

Дополнительную информацию о компонентах contentPane, glassPane и layeredPane можно найти в документации к JRootPane.

В многоэкранной среде вы можете создать JWindow на другом экране. Более подробную информацию смотрите в Window.

Предупреждение: Swing не потокобезопасен. Более подробную информацию см. в Политике потоков Swing.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4, добавлена поддержка долгосрочного хранения всех JavaBeans в пакет java.beans. Подробнее см. XMLEncoder.

С момента:

1.2

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`JWindow.AccessibleJWindow`	Этот класс реализует поддержку доступности для класса `JWindow`.

Вложенные классы/интерфейсы, объявленные в классе java.awt.Window

Window.AccessibleAWTWindow, Window.Type

Вложенные классы/интерфейсы, объявленные в классе java.awt.Container

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, объявленные в классе java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

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

Модификатор и тип	Поле	Описание
`protected AccessibleContext`	`accessibleContext`	Свойство контекста доступности.
`protected JRootPane`	`rootPane`	Экземпляр `JRootPane`, который управляет `contentPane` и необязательными `menuBar` для этой рамки, а также `glassPane`.
`protected boolean`	`rootPaneCheckingEnabled`	Если true, то вызовы `add` и `setLayout` будут перенаправлены на `contentPane`.

Поля, объявленные в классе java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

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

Конструктор	Описание
`JWindow()`	Создаёт окно без указанного владельца.
`JWindow(Frame owner)`	Создаёт окно с указанной рамкой-владельцем.
`JWindow(GraphicsConfiguration gc)`	Создаёт окно с указанным `GraphicsConfiguration` устройства экрана.
`JWindow(Window owner)`	Создаёт окно с указанным окном-владельцем.
`JWindow(Window owner, GraphicsConfiguration gc)`	Создаёт окно с указанным окном-владельцем и `GraphicsConfiguration` устройства экрана.

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

Модификатор и тип	Метод	Описание
`protected void`	`addImpl(Component comp, Object constraints, int index)`	Добавляет указанного дочернего элемента `Component`.
`protected JRootPane`	`createRootPane()`	Вызывается методами-конструкторами для создания стандартного `rootPane`.
`AccessibleContext`	`getAccessibleContext()`	Получает AccessibleContext, связанный с данным JWindow.
`Container`	`getContentPane()`	Возвращает `Container`, который является `contentPane` для данного окна.
`Component`	`getGlassPane()`	Возвращает `glassPane Component` для данного окна.
`Graphics`	`getGraphics()`	Создаёт контекст графики для данного компонента.
`JLayeredPane`	`getLayeredPane()`	Возвращает объект `layeredPane` для данного окна.
`JRootPane`	`getRootPane()`	Возвращает объект `rootPane` для данного окна.
`TransferHandler`	`getTransferHandler()`	Получает свойство `transferHandler`.
`protected boolean`	`isRootPaneCheckingEnabled()`	Возвращает, пересылаются ли вызовы `add` и `setLayout` в `contentPane`.
`protected String`	`paramString()`	Возвращает строковое представление данного `JWindow`.
`void`	`remove(Component comp)`	Удаляет указанный компонент из контейнера.
`void`	`repaint(long time, int x, int y, int width, int height)`	Перерисовывает указанный прямоугольник данного компонента в течение `time` миллисекунд.
`void`	`setContentPane(Container contentPane)`	Устанавливает свойство `contentPane` для данного окна.
`void`	`setGlassPane(Component glassPane)`	Устанавливает свойство `glassPane`.
`void`	`setLayeredPane(JLayeredPane layeredPane)`	Устанавливает свойство `layeredPane`.
`void`	`setLayout(LayoutManager manager)`	Устанавливает `LayoutManager`.
`protected void`	`setRootPane(JRootPane root)`	Устанавливает новый объект `rootPane` для данного окна.
`protected void`	`setRootPaneCheckingEnabled(boolean enabled)`	Устанавливает, пересылаются ли вызовы `add` и `setLayout` в `contentPane`.
`void`	`setTransferHandler(TransferHandler newHandler)`	Устанавливает свойство `transferHandler`, которое является механизмом для поддержки передачи данных в этот компонент.
`void`	`update(Graphics g)`	Вызывает `paint(g)`.
`protected void`	`windowInit()`	Вызывается конструкторами для правильной инициализации `JWindow`.

Методы, унаследованные от класса java.awt.Window

addNotify, 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, 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, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, 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, 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, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, 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

Подробное описание полей

rootPane

protected JRootPane rootPane

Экземпляр JRootPane, управляющий contentPane и необязательными menuBar для этого фрейма, а также glassPane.

См. также:

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

Если true, вызовы add и setLayout будут перенаправлены в contentPane. Изначально false, но устанавливается в true при создании JWindow.

См. также:

accessibleContext

protected AccessibleContext accessibleContext

Свойство контекста доступности.

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

JWindow

public JWindow()

Создает окно без указанного владельца. Это окно не будет фокусируемым.

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

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

JWindow

public JWindow(GraphicsConfiguration gc)

Создает окно со заданной GraphicsConfiguration устройства экрана. Это окно не будет фокусируемым.

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

Параметры:

gc - GraphicsConfiguration, используемая для построения нового окна; если gc равна null, предполагается системный по умолчанию GraphicsConfiguration

Исключения:

HeadlessException - Если GraphicsEnvironment.isHeadless() возвращает true.

IllegalArgumentException - если gc не с устройства экрана.

С тех пор как:

1.3

См. также:

JWindow

public JWindow(Frame owner)

Создает окно со указанным фреймом-владельцем. Если owner равна null, используется общий владелец, и это окно не будет фокусируемым. Также это окно не будет фокусируемым, если его владелец не отображается на экране.

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

Параметры:

owner - фрейм, из которого отображается окно

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

JWindow

public JWindow(Window owner)

Создаёт окно с указанным окном-владельцем. Это окно не будет фокусируемым, если его владелец не отображается на экране. Если owner является null, используется общий владелец, и это окно не будет фокусируемым.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

Parameters:

owner - окно, из которого отображается окно

Throws:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

See Also:

JWindow

public JWindow(Window owner, GraphicsConfiguration gc)

Создаёт окно с указанным окном-владельцем и GraphicsConfiguration устройства экрана. Если owner является null, используется общий владелец, и это окно не будет фокусируемым.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

Parameters:

owner - окно, из которого отображается окно

gc - GraphicsConfiguration, используемое для создания нового окна; если gc является null, используется системный по умолчанию GraphicsConfiguration, за исключением случаев, когда owner также является null, в этом случае используется GraphicsConfiguration из окна-владельца.

Throws:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

IllegalArgumentException - если gc не с устройства экрана.

Since:

1.3

See Also:

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

windowInit

protected void windowInit()

Вызывается конструкторами для правильной инициализации JWindow.

createRootPane

protected JRootPane createRootPane()

Вызывается методами-конструкторами для создания стандартного rootPane.

Returns:: новый JRootPane

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

Возвращает, будут ли вызовы add и setLayout перенаправлены на contentPane.

Returns:

true, если add и setLayout перенаправляются; false в противном случае

See Also:

setTransferHandler

@BeanProperty(hidden=true, description="Mechanism for transfer of data into the component") public void setTransferHandler(TransferHandler newHandler)

Устанавливает свойство transferHandler, являющееся механизмом поддержки передачи данных в этот компонент. Используйте null, если компонент не поддерживает операции передачи данных.

Если системная переменная suppressSwingDropSupport имеет значение false (по умолчанию), а текущий целевой объект перетаскивания на этом компоненте является либо null, либо не заданным пользователем целевым объектом перетаскивания, этот метод изменит целевой объект перетаскивания следующим образом: Если newHandler равно null, целевой объект перетаскивания будет очищен. В противном случае, если это не null, будет установлен новый целевой объект DropTarget.

Примечание: при использовании с JWindow, TransferHandler предоставляет только возможность импорта данных, так как методы, связанные с экспортом данных, в настоящее время имеют тип JComponent.

Дополнительную информацию см. в разделе Как использовать перетаскивание и передачу данных в учебнике Java Tutorial.

Parameters:

newHandler - новое значение TransferHandler

Since:

1.6

See Also:

getTransferHandler

public TransferHandler getTransferHandler()

Возвращает свойство transferHandler.

Returns:

значение свойства transferHandler

Since:

1.6

See Also:

update

public void update(Graphics g)

Вызывает paint(g). Этот метод был переопределен для предотвращения ненужного вызова очистки фона.

Overrides:

update в классе Container

Parameters:

g - контекст Graphics для рисования

See Also:

setRootPaneCheckingEnabled

@BeanProperty(hidden=true, description="Whether the add and setLayout methods are forwarded") protected void setRootPaneCheckingEnabled(boolean enabled)

Устанавливает, пересылаются ли вызовы add и setLayout в contentPane.

Parameters:

enabled - true, если вызовы add и setLayout пересылаются, false — если они должны выполняться напрямую на JWindow.

See Also:

addImpl

protected void addImpl(Component comp, Object constraints, int index)

Добавляет указанный дочерний компонент Component. Этот метод переопределен для условной переадресации вызовов в contentPane. По умолчанию дети добавляются в contentPane вместо фрейма. Подробности см. в RootPaneContainer.

Overrides:

addImpl в классе Container

Parameters:

comp - компонент, который необходимо добавить

constraints - ограничения, которые необходимо соблюдать

index - индекс

Throws:

IllegalArgumentException - если index недействителен

IllegalArgumentException - если родитель контейнера добавляется в себя

IllegalArgumentException - если окно добавляется в контейнер

See Also:

удалить

public void remove(Component comp)

Удаляет указанный компонент из контейнера. Если comp не является rootPane, это перенаправит вызов в contentPane. Это ничего не сделает, если comp не является потомком JWindow или contentPane.

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

remove в классе Container

Параметры:

comp - компонент, который нужно удалить

Исключение:

NullPointerException - если comp равно null

См. также:

setLayout

public void setLayout(LayoutManager manager)

Устанавливает LayoutManager. Переопределено для условного перенаправления вызова в contentPane. Дополнительную информацию см. в RootPaneContainer.

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

setLayout в классе Container

Параметры:

manager - LayoutManager

См. также:

getRootPane

@BeanProperty(bound=false, hidden=true, description="the RootPane object for this window.") public JRootPane getRootPane()

Возвращает объект rootPane для данного окна.

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

getRootPane в интерфейсе RootPaneContainer

Возвращает:

свойство rootPane для данного окна

См. также:

setRootPane

protected void setRootPane(JRootPane root)

Устанавливает новый объект rootPane для этого окна. Этот метод вызывается конструктором.

Параметры:

root - новое свойство rootPane

См. также:

getContentPane

public Container getContentPane()

Возвращает Container, который является contentPane для этого окна.

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

getContentPane в интерфейсе RootPaneContainer

Возвращает:

свойство contentPane

См. также:

setContentPane

@BeanProperty(bound=false, hidden=true, description="The client area of the window where child components are normally inserted.") public void setContentPane(Container contentPane)

Устанавливает свойство contentPane для этого окна. Этот метод вызывается конструктором.

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

setContentPane в интерфейсе RootPaneContainer

Параметры:

contentPane - новое contentPane

Исключение:

IllegalComponentStateException - (исключение времени выполнения) если параметр содержимого панели является null

См. также:

getLayeredPane

public JLayeredPane getLayeredPane()

Возвращает объект layeredPane для данного окна.

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

getLayeredPane в интерфейсе RootPaneContainer

Возвращает:

свойство layeredPane

См. также:

setLayeredPane

@BeanProperty(bound=false, hidden=true, description="The pane which holds the various window layers.") public void setLayeredPane(JLayeredPane layeredPane)

Устанавливает свойство layeredPane. Этот метод вызывается конструктором.

Specified by:

setLayeredPane in interface RootPaneContainer

Parameters:

layeredPane - новый объект layeredPane

Throws:

IllegalComponentStateException - (исключение времени выполнения) если параметр контент-панели null

See Also:

getGlassPane

public Component getGlassPane()

Возвращает glassPane Component для этого окна.

Specified by:

getGlassPane in interface RootPaneContainer

Returns:

свойство glassPane

See Also:

setGlassPane

@BeanProperty(bound=false, hidden=true, description="A transparent pane used for menu rendering.") public void setGlassPane(Component glassPane)

Устанавливает свойство glassPane. Этот метод вызывается конструктором.

Specified by:

setGlassPane in interface RootPaneContainer

Parameters:

glassPane - объект glassPane для этого окна

See Also:

getGraphics

@BeanProperty(bound=false) public Graphics getGraphics()

Создаёт контекст графики для этого компонента. Этот метод вернёт null, если этот компонент в данный момент не отображается.

Overrides:

getGraphics in class Component

Returns:

контекст графики для этого компонента или null, если его нет

Since:

1.6

See Also:

repaint

public void repaint(long time, int x, int y, int width, int height)

Перерисовывает указанный прямоугольник этого компонента в течение time миллисекунд. См. RepaintManager для получения подробностей о том, как обрабатывается перерисовка.

Overrides:

repaint in class Component

Parameters:

time - максимальное время в миллисекундах до обновления

x - координата x

y - координата y

width - ширина

height - высота

Since:

1.6

See Also:

paramString

protected String paramString()

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

Overrides:: paramString in class Container
Returns:: строковое представление этого JWindow

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Specified by:: getAccessibleContext in interface Accessible
Overrides:: getAccessibleContext in class Window
Returns:: AccessibleJWindow, служащий AccessibleContext этого JWindow

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