Класс JDialog

Все реализованные интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants 
@JavaBean(defaultProperty="JMenuBar",
          description="A toplevel window for creating dialog boxes.")
public class JDialog
extends Dialog
implements WindowConstants, Accessible, RootPaneContainer

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

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

dialog.add(child);
А дочерний элемент будет добавлен в contentPane. Компонент contentPane всегда не-null. Попытка установить его в значение null вызывает исключение. У стандартного contentPane установлен менеджер BorderLayout. Подробности о добавлении, удалении и установке LayoutManager JDialog см. в RootPaneContainer.

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

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

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

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

С тех пор:
1.2
См. также:
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

AccessibleContext связанный с этим JDialog
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

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

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

Поля, объявленные в интерфейсе javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

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

Конструктор Описание
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, setModal, setModalityType, setResizable, 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, 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, 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
См. также:
getRootPane(), setRootPane(javax.swing.JRootPane)

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

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

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

accessibleContext

protected AccessibleContext accessibleContext

AccessibleContext связанный с этим JDialog

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

JDialog

public JDialog()

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

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

ПРИМЕЧАНИЕ. Этот конструктор не позволяет создавать JDialog без владельца. Чтобы создать JDialog без владельца, необходимо использовать конструктор JDialog(Window) или JDialog(Dialog) с аргументом null.

Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Frame owner)

Создает модальное диалоговое окно с указанным Frame в качестве владельца и пустым заголовком. Если owner является null, в качестве владельца диалогового окна будет установлена общая скрытая рамка.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

ПРИМЕЧАНИЕ. Этот конструктор не позволяет создавать JDialog без владельца. Чтобы создать JDialog без владельца, необходимо использовать конструктор JDialog(Window) или JDialog(Dialog) с аргументом null.

Параметры:
owner - Frame, из которого отображается диалоговое окно
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Frame owner,
               boolean modal)

Создает диалоговое окно с пустым заголовком, указанной модальностью и Frame в качестве владельца. Если owner является null, в качестве владельца диалогового окна будет установлена общая скрытая рамка.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

ПРИМЕЧАНИЕ. Этот конструктор не позволяет создавать JDialog без владельца. Чтобы создать JDialog без владельца, необходимо использовать конструктор JDialog(Window) или JDialog(Dialog) с аргументом null.

Параметры:
owner - Frame, из которого отображается диалоговое окно
modal - указывает, блокирует ли диалоговое окно ввод пользователя в другие окна верхнего уровня при отображении. Если true, свойство типа модальности устанавливается в DEFAULT_MODALITY_TYPE, в противном случае диалоговое окно является безмодальным.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Frame owner,
               String title)

Создает модальное диалоговое окно с указанным заголовком и указанной главной рамкой. Если owner является null, в качестве владельца диалогового окна будет установлена общая скрытая рамка.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

ПРИМЕЧАНИЕ. Этот конструктор не позволяет создавать JDialog без владельца. Чтобы создать JDialog без владельца, необходимо использовать конструктор JDialog(Window) или JDialog(Dialog) с аргументом null.

Параметры:
owner - Frame, из которого отображается диалоговое окно
title - String, отображаемый в строке заголовка диалогового окна
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Frame owner,
               String title,
               boolean modal)

Создает диалоговое окно с указанным заголовком, владельцем Frame и модальностью. Если owner является null, в качестве владельца этого диалогового окна будет установлена общая скрытая рамка.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

ПРИМЕЧАНИЕ. Любые всплывающие компоненты (JComboBox, JPopupMenu, JMenuBar) созданные в модальном диалоговом окне будут принудительно лёгкими.

ПРИМЕЧАНИЕ. Этот конструктор не позволяет создавать JDialog без владельца. Чтобы создать JDialog без владельца, необходимо использовать конструктор JDialog(Window) или JDialog(Dialog) с аргументом null.

Параметры:
owner - Frame, из которого отображается диалоговое окно
title - String, отображаемый в строке заголовка диалогового окна
modal - указывает, блокирует ли диалоговое окно ввод пользователя в другие окна верхнего уровня при отображении. Если true, свойство типа модальности устанавливается в DEFAULT_MODALITY_TYPE, в противном случае диалоговое окно является безмодальным
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
Dialog.ModalityType, Dialog.ModalityType.MODELESS, Dialog.DEFAULT_MODALITY_TYPE, Dialog.setModal(boolean), Dialog.setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Frame owner,
               String title,
               boolean modal,
               GraphicsConfiguration gc)

Создает диалоговое окно с указанным заголовком, владельцем Frame, модальностью и GraphicsConfiguration. Если owner является null, в качестве владельца этого диалогового окна будет установлена общая скрытая рамка.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

ПРИМЕЧАНИЕ. Любые всплывающие компоненты (JComboBox, JPopupMenu, JMenuBar) созданные в модальном диалоговом окне будут принудительно лёгкими.

ПРИМЕЧАНИЕ. Этот конструктор не позволяет создавать JDialog без владельца. Чтобы создать JDialog без владельца, необходимо использовать конструктор JDialog(Window) или JDialog(Dialog) с аргументом null.

Параметры:
owner - Frame, из которого отображается диалоговое окно
title - String, отображаемый в строке заголовка диалогового окна
modal - указывает, блокирует ли диалоговое окно ввод пользователя в другие окна верхнего уровня при отображении. Если true, свойство типа модальности устанавливается в DEFAULT_MODALITY_TYPE, в противном случае диалоговое окно является безмодальным.
gc - GraphicsConfiguration целевого экранного устройства; если null, используется стандартное системное GraphicsConfiguration
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
С версии:
1.4
См. также:
Dialog.ModalityType, Dialog.ModalityType.MODELESS, Dialog.DEFAULT_MODALITY_TYPE, Dialog.setModal(boolean), Dialog.setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Dialog owner)

Создает модальное диалоговое окно с указанным Dialog в качестве владельца и пустым заголовком.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

Параметры:
owner - владелец Dialog, из которого отображается диалоговое окно, или null, если у этого диалогового окна нет владельца
Исключения:
HeadlessException - if GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Dialog owner,
               boolean modal)

Создает диалоговое окно с пустым заголовком, указанной модальностью и Dialog в качестве владельца.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

Параметры:
owner - владелец Dialog, из которого отображается диалог, или null если у этого диалога нет владельца
modal - указывает, блокирует ли диалог пользовательский ввод в других окнах верхнего уровня при отображении. Если true, свойство типа модальности устанавливается в DEFAULT_MODALITY_TYPE, в противном случае диалог безмодальный.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
Dialog.ModalityType, Dialog.ModalityType.MODELESS, Dialog.DEFAULT_MODALITY_TYPE, Dialog.setModal(boolean), Dialog.setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Dialog owner,
               String title)

Создает безмодальный диалог с указанным заголовком и указанным диалоговым окном-владельцем.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

Параметры:
owner - владелец Dialog, из которого отображается диалог, или null если у этого диалога нет владельца
title - String для отображения в строке заголовка диалогового окна
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Dialog owner,
               String title,
               boolean modal)

Создает диалог с указанным заголовком, модальностью и указанным владельцем Dialog.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

Параметры:
owner - владелец Dialog, из которого отображается диалог, или null если у этого диалога нет владельца
title - String для отображения в строке заголовка диалогового окна
modal - указывает, блокирует ли диалог пользовательский ввод в других окнах верхнего уровня при отображении. Если true, свойство типа модальности устанавливается в DEFAULT_MODALITY_TYPE, в противном случае диалог безмодальный
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
Dialog.ModalityType, Dialog.ModalityType.MODELESS, Dialog.DEFAULT_MODALITY_TYPE, Dialog.setModal(boolean), Dialog.setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Dialog owner,
               String title,
               boolean modal,
               GraphicsConfiguration gc)

Создает диалог с указанным заголовком, владельцем Dialog, модальностью и GraphicsConfiguration.

ПРИМЕЧАНИЕ: Любые всплывающие компоненты (JComboBox, JPopupMenu, JMenuBar) созданные внутри модального диалога, будут принудительно легкими.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

Параметры:
owner - владелец Dialog, из которого отображается диалог, или null если у этого диалога нет владельца
title - String для отображения в строке заголовка диалогового окна
modal - указывает, блокирует ли диалог пользовательский ввод в других окнах верхнего уровня при отображении. Если true, свойство типа модальности устанавливается в DEFAULT_MODALITY_TYPE, в противном случае диалог безмодальный
gc - GraphicsConfiguration целевого устройства экрана; если null, предполагается стандартная системная GraphicsConfiguration
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
С:
1.4
См. также:
Dialog.ModalityType, Dialog.ModalityType.MODELESS, Dialog.DEFAULT_MODALITY_TYPE, Dialog.setModal(boolean), Dialog.setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Window owner)

Создает безмодальный диалог со указанным Window в качестве владельца и пустым заголовком.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

Параметры:
owner - Window из которого отображается диалог, или null если у этого диалога нет владельца
Исключения:
IllegalArgumentException - если owner не является экземпляром Dialog или Frame
IllegalArgumentException - если owner's GraphicsConfiguration не из устройства экрана
HeadlessException - когда GraphicsEnvironment.isHeadless() возвращает true
С:
1.6
См. также:
GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Window owner,
               Dialog.ModalityType modalityType)

Создает диалог с пустым заголовком, указанной модальностью и Window в качестве владельца.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

Параметры:
owner - Window из которого отображается диалог, или null если у этого диалога нет владельца
modalityType - указывает, блокирует ли диалог ввод в другие окна при отображении. null значение и неуправляемые типы модальности эквивалентны MODELESS
Исключения:
IllegalArgumentException - если owner не является экземпляром Dialog или Frame
IllegalArgumentException - если owner's GraphicsConfiguration не из устройства экрана
HeadlessException - когда GraphicsEnvironment.isHeadless() возвращает true
SecurityException - если вызывающая нить не имеет разрешения на создание модальных диалогов с заданным modalityType
С:
1.6
См. также:
Dialog.ModalityType, Dialog.setModal(boolean), Dialog.setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Window owner,
               String title)

Создаёт безмодальный диалог с указанным заголовком и владельцем Window.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

Параметры:
owner - Window из которого отображается диалог, или null если у этого диалога нет владельца
title - String для отображения в строке заголовка диалогового окна, или null если у диалога нет заголовка
Исключения:
IllegalArgumentException - если owner не является экземпляром Dialog или Frame
IllegalArgumentException - если owner's GraphicsConfiguration не из устройства экрана
HeadlessException - когда GraphicsEnvironment.isHeadless() возвращает true
С:
1.6
См. также:
GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Window owner,
               String title,
               Dialog.ModalityType modalityType)

Создаёт диалог с указанным заголовком, владельцем Window и модальностью.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое JComponent.getDefaultLocale.

Параметры:
owner - владелец диалогового окна, из которого отображается диалог, или Window если у этого диалогового окна нет владельца
title - заголовок для отображения в строке заголовка диалогового окна или null если у диалогового окна нет заголовка
modalityType - указывает, блокирует ли диалоговое окно ввод в других окнах при отображении. null значение и неподдерживаемые типы модальности эквивалентны MODELESS
Исключения:
IllegalArgumentException - если owner не является экземпляром Dialog или Frame
IllegalArgumentException - если owner не имеет GraphicsConfiguration с экрана устройства
HeadlessException - когда GraphicsEnvironment.isHeadless() возвращает true
SecurityException - если поток вызова не имеет разрешения на создание модальных диалогов с заданным modalityType
С:
1.6
См. также:
Dialog.ModalityType, Dialog.setModal(boolean), Dialog.setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Window owner,
               String title,
               Dialog.ModalityType modalityType,
               GraphicsConfiguration gc)

Создаёт диалоговое окно с указанным заголовком, владельцем Window, модальностью и GraphicsConfiguration.

ПРИМЕЧАНИЕ: Любые всплывающие компоненты (JComboBox, JPopupMenu, JMenuBar) созданные внутри модального диалогового окна будут принудительно легкими.

Этот конструктор устанавливает свойство локаль компонента в значение, возвращаемое JComponent.getDefaultLocale.

Параметры:
owner - владелец диалогового окна, из которого отображается диалог, или null если у этого диалогового окна нет владельца
title - заголовок для отображения в строке заголовка диалогового окна или null если у диалогового окна нет заголовка
modalityType - указывает, блокирует ли диалоговое окно ввод в других окнах при отображении. null значение и неподдерживаемые типы модальности эквивалентны MODELESS
gc - GraphicsConfiguration целевого устройства экрана; если null, предполагается системное GraphicsConfiguration по умолчанию
Исключения:
IllegalArgumentException - если owner не является экземпляром Dialog или Frame
IllegalArgumentException - если owner не имеет GraphicsConfiguration с экрана устройства
HeadlessException - когда GraphicsEnvironment.isHeadless() возвращает true
SecurityException - если поток вызова не имеет разрешения на создание модальных диалогов с заданным modalityType
С:
1.6
См. также:
Dialog.ModalityType, Dialog.setModal(boolean), Dialog.setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

Методы

dialogInit

protected void dialogInit()

Вызывается конструкторами для правильной инициализации JDialog.

createRootPane

protected JRootPane createRootPane()

Вызывается методами-конструкторами для создания стандартного rootPane.

Возвращает:
новый JRootPane

processWindowEvent

protected void processWindowEvent(WindowEvent e)

Обрабатывает события окна в зависимости от состояния свойства defaultCloseOperation.

Переопределяет:
processWindowEvent в классе Window
Параметры:
e - событие окна
См. также:
setDefaultCloseOperation(int)

setDefaultCloseOperation

@BeanProperty(preferred=true,
              enumerationValues={"WindowConstants.DO_NOTHING_ON_CLOSE","WindowConstants.HIDE_ON_CLOSE","WindowConstants.DISPOSE_ON_CLOSE"},
              description="The dialog\'s default close operation.")
public void setDefaultCloseOperation(int operation)

Устанавливает операцию, которая будет выполняться по умолчанию, когда пользователь инициирует "закрыть" это диалоговое окно. Вы должны указать один из следующих вариантов:

  • DO_NOTHING_ON_CLOSE (определено в WindowConstants): Ничего не делать; требуется, чтобы программа обрабатывала операцию в методе windowClosing зарегистрированного объекта WindowListener.
  • HIDE_ON_CLOSE (определено в WindowConstants): Автоматически скрывает диалоговое окно после вызова любых зарегистрированных объектов WindowListener.
  • DISPOSE_ON_CLOSE (определено в WindowConstants): Автоматически скрывает и удаляет диалоговое окно после вызова любых зарегистрированных объектов WindowListener.

Значение по умолчанию установлено в HIDE_ON_CLOSE. Изменения значения этого свойства вызывают срабатывание события изменения свойства с именем "defaultCloseOperation".

Примечание: Когда последнее отображаемое окно в виртуальной машине Java (VM) удаляется, VM может завершиться. Для получения дополнительной информации см. Проблемы с потоками AWT.

Параметры:
operation - операция, которая должна быть выполнена при закрытии диалогового окна пользователем
Исключения:
IllegalArgumentException - если значение defaultCloseOperation не является одним из вышеперечисленных допустимых значений
См. также:
Window.addWindowListener(java.awt.event.WindowListener), getDefaultCloseOperation(), WindowConstants

getDefaultCloseOperation

public int getDefaultCloseOperation()

Возвращает операцию, которая выполняется при инициировании пользователем "закрыть" этого диалогового окна.

Возвращает:
целое число, указывающее операцию закрытия окна
См. также:
setDefaultCloseOperation(int)

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, он очистит целевую точку перетаскивания. Если не null, он установит новую DropTarget.

При использовании с JDialog, 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 - контекст Graphics для рисования
См. также:
Component.update(Graphics)

setJMenuBar

@BeanProperty(bound=false,
              hidden=true,
              description="The menubar for accessing pulldown menus from this dialog.")
public void setJMenuBar(JMenuBar menu)

Устанавливает панель меню для этого диалогового окна.

Параметры:
menu - панель меню, которая размещается в диалоговом окне
См. также:
getJMenuBar()

getJMenuBar

public JMenuBar getJMenuBar()

Возвращает панель меню, установленную в этом диалоговом окне.

Возвращает:
панель меню, установленную в этом диалоговом окне
См. также:
setJMenuBar(javax.swing.JMenuBar)

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

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, если они должны выполняться непосредственно на JDialog.
См. также:
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

remove

public void remove(Component comp)

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

Переопределяет:
remove в классе Container
Параметры:
comp - компонент для удаления
Исключения:
NullPointerException - если comp равно null
См. также:
Container.add(java.awt.Component), RootPaneContainer

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 dialog.")
public JRootPane getRootPane()

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

Определено в:
getRootPane в интерфейсе RootPaneContainer
Возвращает:
единственный дочерний элемент JRootPane этого компонента.
См. также:
setRootPane(javax.swing.JRootPane), RootPaneContainer.getRootPane()

setRootPane

protected void setRootPane(JRootPane root)

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

Параметры:
root - объект rootPane для этого диалогового окна
См. также:
getRootPane()

getContentPane

public Container getContentPane()

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

Определено в:
getContentPane в интерфейсе RootPaneContainer
Возвращает:
свойство contentPane
См. также:
setContentPane(java.awt.Container), RootPaneContainer.getContentPane()

setContentPane

@BeanProperty(bound=false,
              hidden=true,
              description="The client area of the dialog where child components are normally inserted.")
public void setContentPane(Container contentPane)

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

Архитектура рисования Swing требует непрозрачного JComponent в иерархии контейнеров. Это обычно обеспечивается панелью содержимого. Если вы заменяете панель содержимого, рекомендуется заменить её непрозрачным JComponent.

Specified by:
setContentPane в интерфейсе RootPaneContainer
Parameters:
contentPane - объект contentPane для этого диалогового окна
Throws:
IllegalComponentStateException - (исключение времени выполнения) если параметр панели содержимого null
See Also:
JRootPane, getContentPane(), RootPaneContainer.setContentPane(java.awt.Container)

getLayeredPane

public JLayeredPane getLayeredPane()

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

Specified by:
getLayeredPane в интерфейсе RootPaneContainer
Returns:
свойство layeredPane
See Also:
setLayeredPane(javax.swing.JLayeredPane), RootPaneContainer.getLayeredPane()

setLayeredPane

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

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

Specified by:
setLayeredPane в интерфейсе RootPaneContainer
Parameters:
layeredPane - новое свойство layeredPane
Throws:
IllegalComponentStateException - (исключение времени выполнения) если параметр панели слоёв равен null
See Also:
getLayeredPane(), RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)

getGlassPane

public Component getGlassPane()

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

Specified by:
getGlassPane в интерфейсе RootPaneContainer
Returns:
свойство glassPane
See Also:
setGlassPane(java.awt.Component), RootPaneContainer.getGlassPane()

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:
getGlassPane(), RootPaneContainer.setGlassPane(java.awt.Component)

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

setDefaultLookAndFeelDecorated

public static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)

Предоставляет подсказку о том, должны ли у вновь созданных JDialog быть декорации окна (такие как рамки, виджеты для закрытия окна, заголовок...) предоставлены текущей темой оформления. Если defaultLookAndFeelDecorated равно true, текущая тема оформления поддерживает предоставление декораций окна, а текущий диспетчер окон поддерживает окна без декораций, тогда у вновь созданных JDialog будут декорации окна, предоставленные текущей темой оформления. В противном случае, у вновь созданных JDialog будут декорации окна, предоставленные текущим диспетчером окон.

Вы можете получить тот же эффект для одного JDialog, выполнив следующее:

JDialog dialog = new JDialog();
    dialog.setUndecorated(true);
    dialog.getRootPane().setWindowDecorationStyle(JRootPane.PLAIN_DIALOG);
Parameters:
defaultLookAndFeelDecorated - Подсказка о том, должна ли текущая тема оформления предоставлять декорации окна
Since:
1.4
See Also:
LookAndFeel.getSupportsWindowDecorations()

isDefaultLookAndFeelDecorated

public static boolean isDefaultLookAndFeelDecorated()

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

Returns:
true, если тема оформления должна предоставлять декорации окна.
Since:
1.4

paramString

protected String paramString()

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

Overrides:
paramString в классе Dialog
Returns:
строковое представление этого JDialog.

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Specified by:
getAccessibleContext в интерфейсе Accessible
Overrides:
getAccessibleContext в классе Dialog
Returns:
AccessibleJDialog, который служит AccessibleContext этого JDialog

© 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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/javax/swing/JDialog.html

Spec-Zone .ru
спецификации, руководства, описания, API