Spec-Zone.ru › OpenJDK 8

Класс 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

Этот класс реализует поддержку доступности для класса 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, 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.

См. также:
isRootPaneCheckingEnabled(), setRootPaneCheckingEnabled(boolean), RootPaneContainer

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 pane null
См. также:
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 pane null
См. также:
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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API