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

       window.add(child);

А дочерний компонент будет добавлен в contentPane. Свойство isVisible этого класса всегда будет равно false. Попытка установить его в значение true приведёт к тому, что метод JWindow вызовет исключение. У объекта JWindow по умолчанию установлен менеджер компоновки contentPane. Обратитесь к RootPaneContainer для получения подробной информации об добавлении, удалении и установке менеджера компоновки для contentPane.

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

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

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

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

Since:

1.2

См. также:

JRootPane

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

Модификатор и тип	Класс	Описание
`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` устройства экрана.

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

Modifier and Type	Method	Description
`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`.

Methods declared in class 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

Methods declared in class 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

Methods declared in class 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

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

rootPane

protected JRootPane rootPane

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

См. также:

getRootPane()
setRootPane(javax.swing.JRootPane)

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

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

См. также:

isRootPaneCheckingEnabled()
setRootPaneCheckingEnabled(boolean)
RootPaneContainer

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.

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:

addImpl(java.awt.Component, java.lang.Object, int)
setLayout(java.awt.LayoutManager)
setRootPaneCheckingEnabled(boolean)
RootPaneContainer

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.

Parameters:

newHandler - новый TransferHandler

Since:

1.6

See Also:

getTransferHandler

public TransferHandler getTransferHandler()

Получает свойство transferHandler.

Returns:

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

Since:

1.6

See Also:

TransferHandler
setTransferHandler(javax.swing.TransferHandler)

обновить

public void update(Graphics g)

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

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

update в классе Container

Параметры:

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

См. также:

Component.update(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(java.awt.Component, java.lang.Object, int)
setLayout(java.awt.LayoutManager)
isRootPaneCheckingEnabled()
RootPaneContainer

addImpl

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

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

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

addImpl в классе Container

Параметры:

comp - компонент, который будет добавлен

constraints - ограничения

index - индекс

Исключения:

IllegalArgumentException - если index некорректны

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

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

См. также:

setRootPaneCheckingEnabled(boolean)
RootPaneContainer

удалить

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

См. также:

setRootPaneCheckingEnabled(boolean)
RootPaneContainer

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

См. также:

getRootPane()

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:

Component.paint(java.awt.Graphics)

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:

RepaintManager

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, 2021, 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/17/docs/api/java.desktop/javax/swing/JWindow.html