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

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

Modifier and Type	Method	Description
`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 владельца. В качестве владельца диалога будет установлен общий скрытый фрейм.

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

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

Исключения:

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

См. также:

JDialog

public JDialog(Frame owner)

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

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

Параметры:

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

Исключения:

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

См. также:

JDialog

public JDialog(Frame owner, boolean modal)

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

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

Параметры:

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

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

Исключения:

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

См. также:

JDialog

public JDialog(Frame owner, String title)

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

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

Параметры:

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

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

Исключения:

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

См. также:

JDialog

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

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

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

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

Параметры:

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

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

Исключения:

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

См. также:

JDialog

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

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

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

Параметры:

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

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

gc - GraphicsConfiguration целевого устройства экрана; если null, предполагается стандартная системная GraphicsConfiguration

Исключения:

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

С:

1.4

См. также:

END_OF_DOCUMENT_MARKER

JDialog

public JDialog(Dialog owner)

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

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

Parameters:

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

Throws:

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

See Also:

JDialog

public JDialog(Dialog owner, boolean modal)

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

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

Parameters:

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

Throws:

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

See Also:

JDialog

public JDialog(Dialog owner, String title)

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

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

Parameters:

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

Throws:

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

See Also:

JDialog

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

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

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

Parameters:

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

Throws:

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

See Also:

JDialog

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

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

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

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

Parameters:

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

gc - GraphicsConfiguration целевого устройства экрана; если null, предполагается стандартное системное GraphicsConfiguration

Throws:

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

Since:

1.4

See Also:

JDialog

public JDialog(Window owner)

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

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

Parameters:

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

Throws:

IllegalArgumentException - если owner не является экземпляром Dialog или Frame

IllegalArgumentException - если owner's GraphicsConfiguration не принадлежит устройству отображения

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

Since:

1.6

See Also:

JDialog

public JDialog(Window owner, Dialog.ModalityType modalityType)

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

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

Parameters:

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

modalityType - определяет, блокирует ли диалоговое окно ввод в других окнах при отображении. Значение null и неподдерживаемые типы модальности эквивалентны MODELESS

Throws:

IllegalArgumentException - если owner не является экземпляром Dialog или Frame

IllegalArgumentException - если owner's GraphicsConfiguration не принадлежит устройству отображения

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

SecurityException - если вызывающая нить не имеет разрешения на создание модальных диалогов с заданным modalityType

Since:

1.6

See Also:

JDialog

public JDialog(Window owner, String title)

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

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

Параметры:

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

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

Исключения:

IllegalArgumentException - если owner не является экземпляром Dialog или Frame

IllegalArgumentException - если owner's GraphicsConfiguration не принадлежит экрану

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

С:

1.6

См. также:

JDialog

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

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

Параметры:

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

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

modalityType - указывает, блокирует ли диалог ввод в других окнах при отображении. null значение и неподдерживаемые типы модальности эквивалентны MODELESS

Исключения:

IllegalArgumentException - если owner не является экземпляром Dialog или Frame

IllegalArgumentException - если owner's GraphicsConfiguration не принадлежит экрану

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

SecurityException - если вызывающая нить не имеет разрешения на создание модальных диалогов с заданным modalityType

С:

1.6

См. также:

JDialog

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

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

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

Параметры:

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

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

gc - GraphicsConfiguration целевого устройства экрана; если null, используется значение по умолчанию для системы GraphicsConfiguration

Исключения:

IllegalArgumentException - если owner не является экземпляром Dialog или Frame

IllegalArgumentException - если owner's GraphicsConfiguration не принадлежит экрану

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

SecurityException - если вызывающая нить не имеет разрешения на создание модальных диалогов с заданным modalityType

С:

1.6

См. также:

Подробные сведения о методах

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 Threading Issues.

Параметры:

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

Исключения:

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

См. также:

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.

Дополнительные сведения см. в разделе How to Use Drag and Drop and Data Transfer в учебнике The Java Tutorial.

Параметры:

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

С:

1.6

См. также:

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

См. также:

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

protected void setRootPane(JRootPane root)

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

Параметры:

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

См. также:

getRootPane()

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

См. также:

Component.paint(java.awt.Graphics)

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

См. также:

RepaintManager

setDefaultLookAndFeelDecorated

public static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)

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

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

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

Параметры:

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

С момента:

1.4

См. также:

LookAndFeel.getSupportsWindowDecorations()

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

© 1993, 2021, 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/17/docs/api/java.desktop/javax/swing/JDialog.html