Класс 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. Обратитесь к RootPaneContainer для получения подробной информации о добавлении, удалении и установке LayoutManager для JDialog.

Подробное описание компонентов 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`.

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

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

Экземпляр 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 для отображения в строке заголовка диалога

Исключения:

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

См. также:

JDialog

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

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

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

Параметры:

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

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

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 для отображения в строке заголовка диалогового окна

Исключения:

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

См. также:

JDialog

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

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

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

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

Параметры:

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

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

Исключения:

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

С:

1.4

См. также:

JDialog

public JDialog(Window owner)

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

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

Параметры:

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

Исключения:

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

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

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

С:

1.6

См. также:

JDialog

public JDialog(Window owner, Dialog.ModalityType modalityType)

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

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

Параметры:

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

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

Исключения:

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

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

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

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

С:

1.6

См. также:

JDialog

public JDialog(Window owner, String title)

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

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

Параметры:

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

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

Исключения:

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

IllegalArgumentException - если owner's GraphicsConfiguration не с устройства экрана

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

С:

1.6

См. также:

JDialog

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

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

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

Параметры:

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

title - String, отображаемое в строке заголовка диалогового окна, или 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) созданные внутри модального диалогового окна будут вынуждены быть лёгкими.

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

Параметры:

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

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

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

Исключения:

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

IllegalArgumentException - если owner's 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 (по умолчанию), и текущий объект drop target в этом компоненте равен null или не является объектом drop target, установленным пользователем, этот метод изменит drop target следующим образом: Если newHandler равно null он очистит drop target. Если нет 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 - (исключение времени выполнения) если параметр 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 равно 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. Для JDialogs AccessibleContext принимает форму AccessibleJDialog. Новый экземпляр AccessibleJDialog создаётся при необходимости.

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

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