Класс JWindow
- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- java.awt.Window
-
- javax.swing.JWindow
- Все реализованные интерфейсы:
- ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer
public class JWindow extends Window implements Accessible, RootPaneContainer
A JWindow является контейнером, который может быть отображен в любом месте рабочего стола пользователя. Он не имеет строки заголовка, кнопок управления окном или других элементов, связанных с окном, но всё же является полноценным элементом рабочего стола и может находиться в любом месте на нём.
Компонент 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, поддержка долгосрочного хранения всех JavaBeans™ была добавлена в пакет java.beans. Подробнее см. XMLEncoder.
- См. также:
JRootPane
Вложенные классы
| Модификатор и тип | Класс и описание |
|---|---|
protected class |
JWindow.AccessibleJWindow Этот класс реализует поддержку доступности для класса |
Вложенные классы/интерфейсы, унаследованные от класса 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 Экземпляр |
protected boolean |
rootPaneCheckingEnabled Если true, то вызовы |
Поля, унаследованные от класса 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) Создаёт окно с указанным |
JWindow(Window owner) Создаёт окно с указанным окном-владельцем. |
JWindow(Window owner,
GraphicsConfiguration gc) Создаёт окно с указанным окном-владельцем и |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
protected void |
addImpl(Component comp,
Object constraints,
int index) Добавляет указанный дочерний |
protected JRootPane |
createRootPane() Вызывается методами-конструкторами для создания значения по умолчанию для |
AccessibleContext |
getAccessibleContext() Возвращает AccessibleContext, связанный с этим JWindow. |
Container |
getContentPane() Возвращает |
Component |
getGlassPane() Возвращает |
Graphics |
getGraphics() Создаёт графический контекст для этого компонента. |
JLayeredPane |
getLayeredPane() Возвращает объект |
JRootPane |
getRootPane() Возвращает объект |
TransferHandler |
getTransferHandler() Возвращает свойство |
protected boolean |
isRootPaneCheckingEnabled() Возвращает, перенаправляются ли вызовы |
protected String |
paramString() Возвращает строковое представление этого |
void |
remove(Component comp) Удаляет указанный компонент из контейнера. |
void |
repaint(long time,
int x,
int y,
int width,
int height) Перерисовывает указанный прямоугольник этого компонента в течение |
void |
setContentPane(Container contentPane) Устанавливает свойство |
void |
setGlassPane(Component glassPane) Устанавливает свойство |
void |
setLayeredPane(JLayeredPane layeredPane) Устанавливает свойство |
void |
setLayout(LayoutManager manager) Устанавливает |
protected void |
setRootPane(JRootPane root) Устанавливает новый объект |
protected void |
setRootPaneCheckingEnabled(boolean enabled) Устанавливает, перенаправляются ли вызовы |
void |
setTransferHandler(TransferHandler newHandler) Устанавливает свойство |
void |
update(Graphics g) Вызывает |
protected void |
windowInit() Вызывается конструкторами для правильной инициализации |
Методы, унаследованные от класса 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, removeNotify, 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, 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, getPeer, 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, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, 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.
- См. также:
-
getRootPane(),setRootPane(javax.swing.JRootPane)
rootPaneCheckingEnabled
protected boolean rootPaneCheckingEnabled
Если true, то вызовы add и setLayout будут перенаправлены на contentPane. Изначально false, но устанавливается в true при создании JWindow.
accessibleContext
protected AccessibleContext accessibleContext
Свойство контекста доступности.
Конструкторы
JWindow
public JWindow()
Создает окно без указанного владельца. Это окно не будет фокусируемым.
Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.
- Исключения:
-
HeadlessException- еслиGraphicsEnvironment.isHeadless()возвращает true. - См. также:
-
GraphicsEnvironment.isHeadless(),Window.isFocusableWindow(),JComponent.getDefaultLocale()
JWindow
public JWindow(GraphicsConfiguration gc)
Создает окно с указанной GraphicsConfiguration устройства экрана. Это окно не будет фокусируемым.
Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.
- Параметры:
-
gc-GraphicsConfiguration, используемая для создания нового окна; если gc равноnull, предполагается системная по умолчаниюGraphicsConfiguration - Исключения:
-
HeadlessException- ЕслиGraphicsEnvironment.isHeadless()возвращает true. -
IllegalArgumentException- еслиgcне из устройства экрана. - С тех пор:
- 1.3
- См. также:
-
GraphicsEnvironment.isHeadless(),Window.isFocusableWindow(),JComponent.getDefaultLocale()
JWindow
public JWindow(Frame owner)
Создает окно с указанным фреймом-владельцем. Если owner равно null, используется общий владелец, и это окно не будет фокусируемым. Кроме того, это окно не будет фокусируемым, если его владелец не отображается на экране.
Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.
- Параметры:
-
owner- фрейм, из которого отображается окно - Исключения:
-
HeadlessException- если GraphicsEnvironment.isHeadless() возвращает true. - См. также:
-
GraphicsEnvironment.isHeadless(),Window.isFocusableWindow(),JComponent.getDefaultLocale()
JWindow
public JWindow(Window owner)
Создает окно с указанным окном-владельцем. Это окно не будет фокусируемым, если его владелец не отображается на экране. Если owner равно null, используется общий владелец, и это окно не будет фокусируемым.
Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.
- Параметры:
-
owner- окно, из которого отображается окно - Исключения:
-
HeadlessException- еслиGraphicsEnvironment.isHeadless()возвращает true. - См. также:
-
GraphicsEnvironment.isHeadless(),Window.isFocusableWindow(),JComponent.getDefaultLocale()
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
- См. также:
-
GraphicsEnvironment.isHeadless(),Window.isFocusableWindow(),JComponent.getDefaultLocale()
Методы
windowInit
protected void windowInit()
Вызывается конструкторами для правильной инициализации JWindow.
createRootPane
protected JRootPane createRootPane()
Вызывается методами конструктора для создания по умолчанию rootPane.
isRootPaneCheckingEnabled
protected boolean isRootPaneCheckingEnabled()
Возвращает, перенаправляются ли вызовы add и setLayout на contentPane.
- Возвращает:
- true, если
addиsetLayoutперенаправляются; false в противном случае - См. также:
-
addImpl(java.awt.Component, java.lang.Object, int),setLayout(java.awt.LayoutManager),setRootPaneCheckingEnabled(boolean),RootPaneContainer
setTransferHandler
public void setTransferHandler(TransferHandler newHandler)
Устанавливает свойство transferHandler, представляющее механизм поддержки передачи данных в этот компонент. Используйте null в случае, если компонент не поддерживает операции передачи данных.
Если системная переменная suppressSwingDropSupport равна false (по умолчанию), и текущий целевой объект перетаскивания на этом компоненте равен null или не является целевым объектом перетаскивания, заданным пользователем, этот метод изменит целевой объект перетаскивания следующим образом: Если newHandler равно null, целевой объект перетаскивания будет очищен. Если не null, будет установлен новый DropTarget.
Примечание: При использовании с JWindow, TransferHandler предоставляет только возможность импорта данных, так как методы, связанные с экспортом данных, в настоящее время типизированы как JComponent.
Более подробную информацию см. в разделе Как использовать перетаскивание и передачу данных в Руководстве Java.
- Параметры:
-
newHandler- новыйTransferHandler - С тех пор:
- 1.6
- См. также:
-
TransferHandler,getTransferHandler(),Component.setDropTarget(java.awt.dnd.DropTarget)
getTransferHandler
public TransferHandler getTransferHandler()
Получает свойство transferHandler.
- Возвращает:
- значение свойства
transferHandler - С тех пор:
- 1.6
- См. также:
-
TransferHandler,setTransferHandler(javax.swing.TransferHandler)
update
public void update(Graphics g)
Вызывает paint(g). Этот метод был переопределен, чтобы предотвратить ненужный вызов очистки фона.
- Переопределяет:
-
updateв классеContainer - Параметры:
-
g- контекст рисования - См. также:
Component.update(Graphics)
setRootPaneCheckingEnabled
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 - См. также:
-
Container.add(java.awt.Component),RootPaneContainer
установитьМакет
public void setLayout(LayoutManager manager)
Устанавливает LayoutManager. Переопределено для условного перенаправления вызова на contentPane. Для получения дополнительной информации см. RootPaneContainer.
- Переопределяет:
-
setLayoutв классеContainer - Параметры:
-
manager-LayoutManager - См. также:
-
setRootPaneCheckingEnabled(boolean),RootPaneContainer
getRootPane
public JRootPane getRootPane()
Возвращает объект rootPane для этого окна.
- Определено в:
-
getRootPaneв интерфейсеRootPaneContainer - Возвращает:
- свойство
rootPaneдля этого окна - См. также:
-
setRootPane(javax.swing.JRootPane),RootPaneContainer.getRootPane()
установитьRootPane
protected void setRootPane(JRootPane root)
Устанавливает новый объект rootPane для этого окна. Этот метод вызывается конструктором.
- Параметры:
-
root- новое свойствоrootPane - См. также:
getRootPane()
getContentPane
public Container getContentPane()
Возвращает Container, который является contentPane для этого окна.
- Определено в:
-
getContentPaneв интерфейсеRootPaneContainer - Возвращает:
- свойство
contentPane - См. также:
-
setContentPane(java.awt.Container),RootPaneContainer.getContentPane()
установитьContentPane
public void setContentPane(Container contentPane)
Устанавливает свойство contentPane для этого окна. Этот метод вызывается конструктором.
- Определено в:
-
setContentPaneв интерфейсеRootPaneContainer - Параметры:
-
contentPane- новое свойствоcontentPane - Исключения:
-
IllegalComponentStateException- (исключение времени выполнения) если параметр content panenull - См. также:
-
getContentPane(),RootPaneContainer.setContentPane(java.awt.Container)
получитьСлоированныйПан
public JLayeredPane getLayeredPane()
Возвращает объект layeredPane для этого окна.
- Определено в:
-
getLayeredPaneв интерфейсеRootPaneContainer - Возвращает:
- свойство
layeredPane - См. также:
-
setLayeredPane(javax.swing.JLayeredPane),RootPaneContainer.getLayeredPane()
установитьLayeredPane
public void setLayeredPane(JLayeredPane layeredPane)
Устанавливает свойство layeredPane. Этот метод вызывается конструктором.
- Определено в:
-
setLayeredPaneв интерфейсеRootPaneContainer - Параметры:
-
layeredPane- новый объектlayeredPane - Исключения:
-
IllegalComponentStateException- (исключение времени выполнения) если параметр content panenull - См. также:
-
getLayeredPane(),RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)
получитьGlassPane
public Component getGlassPane()
Возвращает glassPane Component для этого окна.
- Определено в:
-
getGlassPaneв интерфейсеRootPaneContainer - Возвращает:
- свойство
glassPane - См. также:
-
setGlassPane(java.awt.Component),RootPaneContainer.getGlassPane()
установитьGlassPane
public void setGlassPane(Component glassPane)
Устанавливает свойство glassPane. Этот метод вызывается конструктором.
- Определено в:
-
setGlassPaneв интерфейсеRootPaneContainer - Параметры:
-
glassPane- объектglassPaneдля этого окна - См. также:
-
getGlassPane(),RootPaneContainer.setGlassPane(java.awt.Component)
получитьГрафику
public Graphics getGraphics()
Создает контекст графики для этого компонента. Этот метод вернет null, если этот компонент в данный момент не отображается.
- Переопределяет:
-
getGraphicsв классеComponent - Возвращает:
- контекст графики для этого компонента или
null, если его нет - С:
- 1.6
- См. также:
Component.paint(java.awt.Graphics)
перерисовать
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
- См. также:
RepaintManager
paramString
protected String paramString()
Возвращает строковое представление этого JWindow. Этот метод предназначен только для отладки, и содержание и формат возвращаемой строки могут отличаться в разных реализациях. Возвращаемая строка может быть пустой, но не null.
- Переопределяет:
-
paramStringв классеContainer - Возвращает:
- строковое представление этого
JWindow
получитьКонтекстДоступности
public AccessibleContext getAccessibleContext()
Получает AccessibleContext, связанный с этим JWindow. Для JWindow AccessibleContext принимает форму AccessibleJWindow. Новый экземпляр AccessibleJWindow создаётся при необходимости.
- Определено в:
-
getAccessibleContextв интерфейсеAccessible - Переопределяет:
-
getAccessibleContextв классеWindow - Возвращает:
- AccessibleJWindow, который служит AccessibleContext этого JWindow
© 1993, 2020, 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.