Класс JDialog

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - java.awt.Window
    - - java.awt.Dialog
      - javax.swing.JDialog

Все реализованные интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants

public class JDialog
extends Dialog
implements WindowConstants, Accessible, RootPaneContainer

Основной класс для создания диалогового окна. Вы можете использовать этот класс для создания пользовательского диалогового окна или вызвать множество методов класса в JOptionPane для создания различных стандартных диалоговых окон. Для получения информации о создании диалоговых окон см. раздел Руководства по Java Как создать диалоговые окна.

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

dialog.add(child);

И дочерний элемент будет добавлен в contentPane. contentPane всегда null. Попытка установить его в значение null приведет к исключению. У contentPane по умолчанию установлен менеджер BorderLayout. Обратитесь к RootPaneContainer для получения подробной информации о добавлении, удалении и установке LayoutManager диалогового окна JDialog.

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

В многоэкранной среде вы можете создать JDialog на другом экране, отличном от экрана владельца. Дополнительную информацию см. в Frame.

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

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

См. также:: JOptionPane, JRootPane, RootPaneContainer

Вложенные классы

Модификатор и тип	Класс и описание
`protected class`	`JDialog.AccessibleJDialog` Этот класс реализует поддержку доступности для класса `JDialog`.

Вложенные классы/интерфейсы, унаследованные от класса java.awt.Dialog

Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType

Вложенные классы/интерфейсы, унаследованные от класса 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, то вызовы `add` и `setLayout` будут перенаправлены в `contentPane`.

Поля, унаследованные от класса java.awt.Dialog

DEFAULT_MODALITY_TYPE

Поля, унаследованные от класса java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, унаследованные от интерфейса javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Поля, унаследованные от интерфейса java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Конструкторы

Конструктор и описание
`JDialog()` Создает безаналитическое диалоговое окно без заголовка и без указанного владельца `Frame`.
`JDialog(Dialog owner)` Создает безаналитическое диалоговое окно с указанным владельцем `Dialog` и пустым заголовком.
`JDialog(Dialog owner, boolean modal)` Создает диалоговое окно с пустым заголовком, указанной модальностью и указанным владельцем `Dialog`.
`JDialog(Dialog owner, String title)` Создает безаналитическое диалоговое окно с указанным заголовком и указанным владельцем - диалоговым окном.
`JDialog(Dialog owner, String title, boolean modal)` Создает диалоговое окно с указанным заголовком, модальностью и указанным владельцем - `Dialog`.
`JDialog(Dialog owner, String title, boolean modal, GraphicsConfiguration gc)` Создает диалоговое окно с указанным заголовком, владельцем `Dialog`, модальностью и `GraphicsConfiguration`.
`JDialog(Frame owner)` Создает безаналитическое диалоговое окно с указанным владельцем `Frame` и пустым заголовком.
`JDialog(Frame owner, boolean modal)` Создаёт диалоговое окно с пустым заголовком, указанной модальностью и указанным владельцем `Frame`.
`JDialog(Frame owner, String title)` Создаёт безаналитическое диалоговое окно с указанным заголовком и указанной рамой-владельцем.
`JDialog(Frame owner, String title, boolean modal)` Создаёт диалоговое окно с указанным заголовком, владельцем `Frame` и модальностью.
`JDialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)` Создаёт диалоговое окно с указанным заголовком, владельцем `Frame`, модальностью и `GraphicsConfiguration`.
`JDialog(Window owner)` Создаёт безаналитическое диалоговое окно с указанным владельцем `Window` и пустым заголовком.
`JDialog(Window owner, Dialog.ModalityType modalityType)` Создаёт диалоговое окно с пустым заголовком, указанной модальностью и указанным владельцем `Window`.
`JDialog(Window owner, String title)` Создаёт безаналитическое диалоговое окно с указанным заголовком и владельцем `Window`.
`JDialog(Window owner, String title, Dialog.ModalityType modalityType)` Создаёт диалоговое окно с указанным заголовком, владельцем `Window` и модальностью.
`JDialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)` Создаёт диалоговое окно с указанным заголовком, владельцем `Window`, модальностью и `GraphicsConfiguration`.

Методы

Модификатор и тип	Метод и описание
`protected void`	`addImpl(Component comp, Object constraints, int index)` Добавляет указанного дочернего элемента `Component`.
`protected JRootPane`	`createRootPane()` Вызывается методами-конструкторами для создания стандартного `rootPane`.
`protected void`	`dialogInit()` Вызывается конструкторами для правильной инициализации `JDialog`.
`AccessibleContext`	`getAccessibleContext()` Получает AccessibleContext, связанный с этим JDialog.
`Container`	`getContentPane()` Возвращает объект `contentPane` для этого диалогового окна.
`int`	`getDefaultCloseOperation()` Возвращает операцию, которая выполняется при инициировании пользователем "закрытия" этого диалогового окна.
`Component`	`getGlassPane()` Возвращает объект `glassPane` для этого диалогового окна.
`Graphics`	`getGraphics()` Создает контекст графики для этого компонента.
`JMenuBar`	`getJMenuBar()` Возвращает установленную панель меню для этого диалогового окна.
`JLayeredPane`	`getLayeredPane()` Возвращает объект `layeredPane` для этого диалогового окна.
`JRootPane`	`getRootPane()` Возвращает объект `rootPane` для этого диалогового окна.
`TransferHandler`	`getTransferHandler()` Получает свойство `transferHandler`.
`static boolean`	`isDefaultLookAndFeelDecorated()` Возвращает true, если у вновь созданных `JDialog` должны быть предоставлены украшения окна текущей внешней оболочкой.
`protected boolean`	`isRootPaneCheckingEnabled()` Возвращает, передаются ли вызовы `add` и `setLayout` в `contentPane`.
`protected String`	`paramString()` Возвращает строковое представление этого `JDialog`.
`protected void`	`processWindowEvent(WindowEvent e)` Обрабатывает события окна в зависимости от состояния свойства `defaultCloseOperation`.
`void`	`remove(Component comp)` Удаляет указанный компонент из контейнера.
`void`	`repaint(long time, int x, int y, int width, int height)` Перерисовывает указанный прямоугольник этого компонента в течение `time` миллисекунд.
`void`	`setContentPane(Container contentPane)` Устанавливает свойство `contentPane`.
`void`	`setDefaultCloseOperation(int operation)` Устанавливает операцию, которая будет выполнена по умолчанию, когда пользователь инициирует "закрытие" этого диалогового окна.
`static void`	`setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)` Предлагает подсказку о том, должны ли у вновь созданных `JDialog` быть предоставлены украшения окна (например, рамки, виджеты для закрытия окна, заголовок) текущей внешней оболочкой.
`void`	`setGlassPane(Component glassPane)` Устанавливает свойство `glassPane`.
`void`	`setJMenuBar(JMenuBar menu)` Устанавливает панель меню для этого диалогового окна.
`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)`.

Методы, унаследованные от класса java.awt.Dialog

addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, setVisible, show, toBack

Методы, унаследованные от класса java.awt.Window

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, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, 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

См. также:: getRootPane(), setRootPane(javax.swing.JRootPane)

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

Если true, то вызовы add и setLayout будут перенаправлены в contentPane. Изначально это значение false, но устанавливается в true при создании JDialog.

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

accessibleContext

protected AccessibleContext accessibleContext

Конструкторы

JDialog

public JDialog()

Создает модальное диалоговое окно без заголовка и без указанного владельца Frame. В качестве владельца диалогового окна будет установлено общее скрытое фрейм.