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

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

      window.add(child);

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

Полное описание компонентов contentPane, glassPane и layeredPane см. в документации JRootPane.

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

Предупреждение: Swing не является потокобезопасной библиотекой. Дополнительные сведения см. в разделе Политика Swing в отношении потоков.

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

Начиная с версии:

1.2

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`JWindow.AccessibleJWindow`	Этот класс реализует поддержку специальных возможностей для класса `JWindow`.

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

Window.AccessibleAWTWindow, Window.Type

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

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, объявленные в классе 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`.

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

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе 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`.

Методы, объявленные в классе 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

Методы, объявленные в классе 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

Методы, объявленные в классе 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

Методы, объявленные в классе 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.

Параметры:

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

Выбрасывает:

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

См. также:

JWindow

public JWindow(Window owner, GraphicsConfiguration gc)

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

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

Параметры:

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

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

Выбрасывает:

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

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

С версии:

1.3

См. также:

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

windowInit

protected void windowInit()

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

createRootPane

protected JRootPane createRootPane()

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

Возвращает:: новый JRootPane

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

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

Возвращает:

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

См. также:

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.

Параметры:

newHandler — новый TransferHandler

С версии:

1.6

См. также:

getTransferHandler

public TransferHandler getTransferHandler()

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

Возвращает:

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

С версии:

1.6

См. также:

update

public void update(Graphics g)

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

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

update в классе Container

Параметры:

g — контекст Graphics, в котором выполняется рисование

См. также:

setRootPaneCheckingEnabled

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

Задает, будут ли вызовы add и setLayout перенаправляться в contentPane.

Параметры:

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

См. также:

addImpl

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

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

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

addImpl в классе Container

Параметры:

comp — компонент, который нужно добавить

constraints — ограничения, которые необходимо учитывать

index — индекс

Выбрасывает:

IllegalArgumentException — если index недопустим

IllegalArgumentException — при добавлении родительского контейнера в него самого

IllegalArgumentException — при добавлении окна в контейнер

См. также:

remove

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. Этот метод вызывается конструктором.

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

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

Параметры:

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

Выбрасывает:

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

См. также:

getGlassPane

public Component getGlassPane()

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

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

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

Возвращает:

свойство glassPane

См. также:

setGlassPane

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

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

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

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

Параметры:

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

См. также:

getGraphics

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

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

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

getGraphics в классе Component

Возвращает:

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

С версии:

1.6

См. также:

repaint

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

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

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

repaint в классе Component

Параметры:

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

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

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

width — ширина

height — высота

С версии:

1.6

См. также:

paramString

protected String paramString()

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

Переопределяет:: paramString в классе Container
Возвращает:: строковое представление этого JWindow

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Window
Возвращает:: 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JWindow.html