Класс JDialog

javax.swing.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 Как создать диалоговые окна.

Компонент 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

См. также:

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

Модификатор и тип	Класс	Описание
`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`	Экземпляр `JRootPane`, который управляет `contentPane`.
`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

Экземпляр JRootPane, управляющий contentPane.

См. также:

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

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

См. также:

accessibleContext

protected AccessibleContext accessibleContext

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

Подробное описание конструкторов

JDialog

public JDialog()

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

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

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

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

JDialog

public JDialog(Frame owner)

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

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

Параметры:

owner - Frame, из которого отображается диалог

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

JDialog

public JDialog(Frame owner, boolean modal)

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

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

Параметры:

owner - Frame, из которого отображается диалог

modal - определяет, блокирует ли диалог ввод пользователя в других окнах верхнего уровня при показе. Если true, тип модальности устанавливается в DEFAULT_MODALITY_TYPE, иначе диалог немодальный.

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

JDialog

public JDialog(Frame owner, String title)

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

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

Параметры:

owner - Frame, из которого отображается диалог

title - String, отображаемый в строке заголовка диалога

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

JDialog

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

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

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

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

Параметры:

owner - Frame, из которого отображается диалог

title - String, отображаемый в строке заголовка диалога

modal - Указывает, блокирует ли диалог ввод пользователя в других окнах верхнего уровня при показе. Если true, тип модальности устанавливается в DEFAULT_MODALITY_TYPE, иначе диалог немодальный.

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

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

См. также:

JDialog

public JDialog(Dialog owner)

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

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

Параметры:

owner - владелец Dialog, из которого отображается диалоговое окно, или null, если у этого диалогового окна нет владельца

Исключения:

HeadlessException - if GraphicsEnvironment.isHeadless() возвращает true.

См. также:

JDialog

public JDialog(Dialog owner, boolean modal)

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

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

Параметры:

modal - указывает, блокирует ли диалоговое окно ввод пользователем в других окнах верхнего уровня при отображении. Если true, свойство типа модальности устанавливается в DEFAULT_MODALITY_TYPE, в противном случае диалоговое окно безамодальное.

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

JDialog

public JDialog(Dialog owner, String title)

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

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

Параметры:

title - String, отображаемое в строке заголовка диалогового окна

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

JDialog

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

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

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

Параметры:

title - String, отображаемое в строке заголовка диалогового окна

modal - указывает, блокирует ли диалоговое окно ввод пользователем в других окнах верхнего уровня при отображении. Если true, свойство типа модальности устанавливается в DEFAULT_MODALITY_TYPE, в противном случае диалоговое окно безамодальное

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

JDialog

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

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

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

Параметры:

title - String, отображаемое в строке заголовка диалогового окна

modal - указывает, блокирует ли диалоговое окно ввод пользователем в других окнах верхнего уровня при отображении. Если true, свойство типа модальности устанавливается в DEFAULT_MODALITY_TYPE, в противном случае диалоговое окно безамодальное

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

С:

1.4

См. также:

JDialog

public JDialog(Window owner)

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

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

Параметры:

owner - the Window from which the dialog is displayed or null if this dialog has no owner

Исключения:

IllegalArgumentException - if the owner is not an instance of Dialog or Frame

IllegalArgumentException - if the owner's GraphicsConfiguration is not from a screen device

HeadlessException - when GraphicsEnvironment.isHeadless() returns true

С версии:

1.6

См. также:

JDialog

public JDialog(Window owner, Dialog.ModalityType modalityType)

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

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

Параметры:

owner - the Window from which the dialog is displayed or null if this dialog has no owner

modalityType - specifies whether dialog blocks input to other windows when shown. null value and unsupported modality types are equivalent to MODELESS

Исключения:

IllegalArgumentException - if the owner is not an instance of Dialog or Frame

IllegalArgumentException - if the owner's GraphicsConfiguration is not from a screen device

HeadlessException - when GraphicsEnvironment.isHeadless() returns true

С версии:

1.6

См. также:

JDialog

public JDialog(Window owner, String title)

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

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

Параметры:

owner - the Window from which the dialog is displayed or null if this dialog has no owner

title - the String to display in the dialog's title bar or null if the dialog has no title

Исключения:

IllegalArgumentException - if the owner is not an instance of Dialog or Frame

IllegalArgumentException - if the owner's GraphicsConfiguration is not from a screen device

HeadlessException - when GraphicsEnvironment.isHeadless() returns true

С версии:

1.6

См. также:

JDialog

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

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

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

Параметры:

owner - the Window from which the dialog is displayed or null if this dialog has no owner

title - the String to display in the dialog's title bar or null if the dialog has no title

modalityType - specifies whether dialog blocks input to other windows when shown. null value and unsupported modality types are equivalent to MODELESS

Исключения:

IllegalArgumentException - if the owner is not an instance of Dialog or Frame

IllegalArgumentException - if the owner's GraphicsConfiguration is not from a screen device

HeadlessException - when GraphicsEnvironment.isHeadless() returns true

С версии:

1.6

См. также:

JDialog

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

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

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

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

Параметры:

owner - the Window from which the dialog is displayed or null if this dialog has no owner

title - the String to display in the dialog's title bar or null if the dialog has no title

modalityType - specifies whether dialog blocks input to other windows when shown. null value and unsupported modality types are equivalent to MODELESS

gc - the GraphicsConfiguration of the target screen device; if null, the default system GraphicsConfiguration is assumed

Исключения:

IllegalArgumentException - if the owner is not an instance of Dialog or Frame

IllegalArgumentException - if the owner's GraphicsConfiguration is not from a screen device

HeadlessException - when GraphicsEnvironment.isHeadless() returns true

С версии:

1.6

См. также:

Подробное описание методов

dialogInit

protected void dialogInit()

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

createRootPane

protected JRootPane createRootPane()

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

Возвращаемое значение:: новая JRootPane

processWindowEvent

protected void processWindowEvent(WindowEvent e)

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

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

processWindowEvent in class Window

Параметры:

e - the window event

См. также:

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.

Parameters:

operation - операция, которая должна быть выполнена при закрытии диалогового окна пользователем

Throws:

IllegalArgumentException - если значение defaultCloseOperation не соответствует одному из вышеперечисленных допустимых значений

See Also:

getDefaultCloseOperation

public int getDefaultCloseOperation()

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

Returns:

целое число, указывающее операцию закрытия окна

See Also:

setTransferHandler

@BeanProperty(hidden=true, description="Mechanism for transfer of data into the component") public void setTransferHandler(TransferHandler newHandler)

Устанавливает свойство transferHandler, которое является механизмом поддержки передачи данных в этот компонент. Используйте null, если компонент не поддерживает операции передачи данных.

Если системная переменная suppressSwingDropSupport имеет значение false (по умолчанию), а текущий объект Drop Target на этом компоненте является либо null, либо не является пользователем заданным Drop Target, этот метод изменит Drop Target следующим образом: если newHandler равно null, он очистит Drop Target. Если нет null, он установит новый DropTarget.

При использовании с JDialog, TransferHandler предоставляет только возможность импорта данных, так как методы, связанные с экспортом данных, в настоящее время имеют тип JComponent.

Для получения дополнительной информации см. Как использовать перетаскивание и передачу данных – раздел в учебном пособии Java.

Parameters:

newHandler - новое значение TransferHandler

Since:

1.6

See Also:

getTransferHandler

public TransferHandler getTransferHandler()

Возвращает свойство transferHandler.

Returns:

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

Since:

1.6

See Also:

update

public void update(Graphics g)

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

Overrides:

update в классе Container

Parameters:

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

See Also:

setJMenuBar

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

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

Parameters:

menu - строка меню, размещаемая в диалоговом окне

See Also:

getJMenuBar

public JMenuBar getJMenuBar()

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

Returns:

строка меню, установленная для этого диалогового окна

See Also:

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

Возвращает, перенаправляются ли вызовы add и setLayout в contentPane.

Returns:

true, если вызовы add и setLayout перенаправляются; false в противном случае

See Also:

setRootPaneCheckingEnabled

@BeanProperty(hidden=true, description="Whether the add and setLayout methods are forwarded") protected void setRootPaneCheckingEnabled(boolean enabled)

Устанавливает, перенаправляются ли вызовы add и setLayout в contentPane.

Parameters:

enabled - true, если вызовы add и setLayout перенаправляются, false, если они должны выполняться непосредственно над JDialog.

See Also:

addImpl

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

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

Overrides:

addImpl в классе Container

Parameters:

comp - компонент, подлежащий расширению

constraints - ограничения, которые необходимо соблюдать

index - индекс

Throws:

IllegalArgumentException - если index недопустим

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

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

See Also:

remove

public void remove(Component comp)

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

Overrides:

remove в классе Container

Parameters:

comp - компонент, подлежащий удалению

Throws:

NullPointerException - если comp равно null

See Also:

setLayout

public void setLayout(LayoutManager manager)

Устанавливает LayoutManager. Переопределён для условной переадресации вызова в contentPane. Дополнительную информацию см. в RootPaneContainer.

Overrides:

setLayout в классе Container

Parameters:

manager - LayoutManager

See Also:

getRootPane

@BeanProperty(bound=false, hidden=true, description="the RootPane object for this dialog.") public JRootPane getRootPane()

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

Определено в:

getRootPane в интерфейсе RootPaneContainer

Возвращает:

единственный дочерний элемент JRootPane этого компонента.

См. также:

setRootPane

protected void setRootPane(JRootPane root)

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

Параметры:

root - объект rootPane для этого диалогового окна

См. также:

getContentPane

public Container getContentPane()

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

Определено в:

getContentPane в интерфейсе RootPaneContainer

Возвращает:

свойство contentPane

См. также:

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.

Определено в:

setContentPane в интерфейсе RootPaneContainer

Параметры:

contentPane - объект contentPane для этого диалогового окна

Исключения:

IllegalComponentStateException - (исключение времени выполнения) если параметр панели содержимого является null

См. также:

getLayeredPane

public JLayeredPane getLayeredPane()

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

Определено в:

getLayeredPane в интерфейсе RootPaneContainer

Возвращает:

свойство layeredPane

См. также:

setLayeredPane

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

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

Определено в:

setLayeredPane в интерфейсе RootPaneContainer

Параметры:

layeredPane - новое свойство layeredPane

Исключения:

IllegalComponentStateException - (исключение времени выполнения) если параметр layered pane равен null

См. также:

getGlassPane

public Component getGlassPane()

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

Определено в:

getGlassPane в интерфейсе RootPaneContainer

Возвращает:

свойство glassPane

См. также:

setGlassPane

@BeanProperty(bound=false, hidden=true, description="A transparent pane used for menu rendering.") public void setGlassPane(Component glassPane)

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

Определено в:

setGlassPane в интерфейсе RootPaneContainer

Параметры:

glassPane - объект glassPane для этого диалогового окна

См. также:

getGraphics

@BeanProperty(bound=false) public Graphics getGraphics()

Создаёт контекст графики для этого компонента. Этот метод вернёт null, если этот компонент в данный момент недоступен для отображения.

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

getGraphics в классе Component

Возвращает:

контекст графики для этого компонента или null, если его нет

С тех пор, как:

1.6

См. также:

repaint

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

См. также:

setDefaultLookAndFeelDecorated

public static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)

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

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

    JDialog dialog = new JDialog();
    dialog.setUndecorated(true);
    dialog.getRootPane().setWindowDecorationStyle(JRootPane.PLAIN_DIALOG);

Параметры:

defaultLookAndFeelDecorated - подсказка о том, должна ли текущая внешность предоставлять декорации окна

С тех пор, как:

1.4

См. также:

isDefaultLookAndFeelDecorated

public static boolean isDefaultLookAndFeelDecorated()

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

Возвращает:: true, если внешность должна предоставлять декорации окна.
С тех пор, как:: 1.4

paramString

protected String paramString()

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

Переопределяет:: paramString в классе Dialog
Возвращает:: строковое представление этого JDialog.

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Dialog
Возвращает:: AccessibleJDialog, который служит AccessibleContext для этого JDialog

END_OF_DOCUMENT_MARKER

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/JDialog.html