Класс 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 содержит компонент содержимого (contentPane) в качестве единственного дочернего элемента. Дочерние элементы JWindow должны добавляться в компонент содержимого. Для удобства методы этого класса для добавления, удаления и изменения компонентов переопределены и вызывают соответствующие методы компонент содержимого. Например, так можно добавить дочерний компонент к окну:

       window.add(child);

И дочерний компонент будет добавлен в компонент содержимого. Компонент содержимого всегда будет невидимым. Попытка установить его видимость приведёт к исключению. По умолчанию компонент содержимого будет иметь установленный менеджер компоновки. Подробнее о добавлении, удалении и настройке компоновки содержимого см. в RootPaneContainer.

Полное описание компонентов JRootPane, JLayeredPane и JPanel см. в документации к JRootPane.

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

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

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

Since:

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.

Параметры:

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, он очищает область вывода. В противном случае устанавливает новую 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 для рисования

См. также:

END_OF_DOCUMENT_MARKER

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:

remove

public void remove(Component comp)

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

Overrides:

remove в классе Container

Parameters:

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

Throws:

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

See Also:

setLayout

public void setLayout(LayoutManager manager)

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

Overrides:

setLayout в классе Container

Parameters:

manager - LayoutManager

See Also:

getRootPane

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

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

Specified by:

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

Returns:

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

See Also:

setRootPane

protected void setRootPane(JRootPane root)

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

Parameters:

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

See Also:

getContentPane

public Container getContentPane()

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

Specified by:

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

Returns:

свойство contentPane

See Also:

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

Specified by:

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

Parameters:

contentPane - новое значение contentPane

Throws:

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

See Also:

getLayeredPane

public JLayeredPane getLayeredPane()

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

Specified by:

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

Returns:

свойство layeredPane

See Also:

setLayeredPane

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

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

Specified by:

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

Parameters:

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

Throws:

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

See Also:

getGlassPane

public Component getGlassPane()

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

Specified by:

getGlassPane в интерфейсе 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 в интерфейсе RootPaneContainer

Parameters:

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

See Also:

getGraphics

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

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

Overrides:

getGraphics в классе 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 в классе Component

Parameters:

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

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

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

width - ширина

height - высота

Since:

1.6

See Also:

paramString

protected String paramString()

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Window
Возвращает:: AccessibleJWindow, который служит AccessibleContext для этого JWindow

© 1993, 2023, 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/21/docs/api/java.desktop/javax/swing/JWindow.html