Класс 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 в пакет java.beans добавлена поддержка долгосрочного хранения всех JavaBeans. См. документацию XMLEncoder.

Начиная с:

1.2

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`JDialog.AccessibleJDialog`	Этот класс реализует поддержку специальных возможностей для класса `JDialog`.

Вложенные классы и интерфейсы, объявленные в классе Dialog

Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType

Вложенные классы и интерфейсы, объявленные в классе Window

Window.AccessibleAWTWindow, Window.Type

Вложенные классы и интерфейсы, объявленные в классе Container

Container.AccessibleAWTContainer

Вложенные классы и интерфейсы, объявленные в классе 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`.

Поля, объявленные в классе Dialog

DEFAULT_MODALITY_TYPE

Поля, объявленные в классе Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

Поля, объявленные в интерфейсе 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)`.

Методы, объявленные в классе Dialog

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

Методы, объявленные в классе 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

Методы, объявленные в классе 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

Методы, объявленные в классе 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

Методы, объявленные в классе 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 без владельца. Чтобы создать JDialog без владельца, необходимо использовать конструктор JDialog(Window) или JDialog(Dialog) с аргументом null.

Вызывает исключение:

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

См. также:

JDialog

public JDialog(Frame owner)

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

Параметры:

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

Вызывает исключение:

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

См. также:

JDialog

public JDialog(Frame owner, boolean modal)

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

Параметры:

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

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

Вызывает исключение:

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

См. также:

JDialog

public JDialog(Frame owner, String title)

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

Параметры:

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

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

Вызывает исключение:

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

См. также:

JDialog

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

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

ПРИМЕЧАНИЕ: Любые всплывающие компоненты (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, в качестве владельца этого диалога будет задан общий скрытый фрейм.

Параметры:

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

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

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

Вызывает исключение:

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

Начиная с:

1.4

См. также:

JDialog

public JDialog(Dialog owner)

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

Параметры:

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

Вызывает исключение:

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

См. также:

JDialog

public JDialog(Dialog owner, boolean modal)

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

Параметры:

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

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

Вызывает исключение:

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

См. также:

JDialog

public JDialog(Dialog owner, String title)

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

Параметры:

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

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

Вызывает исключение:

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

См. также:

JDialog

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

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

Параметры:

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

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

Вызывает исключение:

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

См. также:

JDialog

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

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

Параметры:

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

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

Вызывает исключение:

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

Начиная с:

1.4

См. также:

JDialog

public JDialog(Window owner)

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

Параметры:

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

Вызывает исключение:

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

IllegalArgumentException — если owner устройства GraphicsConfiguration не является экранным

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

Начиная с:

1.6

См. также:

JDialog

public JDialog(Window owner, Dialog.ModalityType modalityType)

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

Параметры:

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

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

Вызывает исключение:

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

IllegalArgumentException — если owner устройства GraphicsConfiguration не является экранным

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

Начиная с:

1.6

См. также:

JDialog

public JDialog(Window owner, String title)

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

Параметры:

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

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

Вызывает исключение:

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

IllegalArgumentException — если owner устройства GraphicsConfiguration не является экранным

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

Начиная с:

1.6

См. также:

JDialog

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

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

Параметры:

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

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

Вызывает исключение:

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

IllegalArgumentException — если owner устройства GraphicsConfiguration не является экранным

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

Начиная с:

1.6

См. также:

JDialog

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

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

Параметры:

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

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

Вызывает исключение:

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

IllegalArgumentException — если owner устройства GraphicsConfiguration не является экранным

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

Начиная с:

1.6

См. также:

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

dialogInit

protected void dialogInit()

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

createRootPane

protected JRootPane createRootPane()

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

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

processWindowEvent

protected void processWindowEvent(WindowEvent e)

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

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

processWindowEvent в классе Window

Параметры:

e — событие окна

См. также:

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 не входит в число допустимых значений, указанных выше

См. также:

getDefaultCloseOperation

public int getDefaultCloseOperation()

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

Возвращает:

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

См. также:

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

См. также:

getTransferHandler

public TransferHandler getTransferHandler()

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

Возвращает:

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

Начиная с:

1.6

См. также:

update

public void update(Graphics g)

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

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

update в классе Container

Параметры:

g - контекст Graphics, в котором выполняется рисование

См. также:

setJMenuBar

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

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

Параметры:

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

См. также:

getJMenuBar

public JMenuBar getJMenuBar()

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

Возвращает:

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

См. также:

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

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

Возвращает:

true, если add и setLayout перенаправляются; иначе false

См. также:

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

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

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

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

addImpl в классе Container

Параметры:

comp - компонент, который нужно добавить

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

index - индекс

Исключения:

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

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

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

См. также:

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

См. также:

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 (исключение времени выполнения), если параметр слоистой панели равен 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 равно true, текущий 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

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