Класс Dialog

Все реализованные интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible
Прямые известные подклассы:
FileDialog, JDialog 
public class Dialog
extends Window

Диалог — это окно верхнего уровня с заголовком и рамкой, обычно используемое для получения от пользователя определённого вида ввода. Размер диалога включает в себя любую область, выделенную под рамку. Размеры области рамки можно получить с помощью метода getInsets, однако, поскольку эти размеры зависят от платформы, значение insets не может быть получено до тех пор, пока диалог не станет отображаемым, вызвав pack или show. Поскольку область рамки включена в общий размер диалога, рамка фактически скрывает часть диалога, ограничивая область, доступную для отрисовки и/или отображения подкомпонентов, до прямоугольника с верхним левым углом (insets.left, insets.top), и размером width - (insets.left + insets.right) на height - (insets.top + insets.bottom).

Стандартная компоновка для диалога — BorderLayout.

Диалог может иметь отключенные собственные декорации (т.е. рамку и заголовок) с помощью setUndecorated. Это можно сделать только тогда, когда диалог не displayable.

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

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

Диалог может быть безимпульсным (по умолчанию) или модальными. Модальный диалог блокирует ввод в другие окна верхнего уровня приложения, за исключением окон, созданных с диалогом в качестве владельца. Подробности см. в спецификации модальностей AWT по адресу AWT Modality.

Диалоги могут генерировать следующие WindowEvents: WindowOpened, WindowClosing, WindowClosed, WindowActivated, WindowDeactivated, WindowGainedFocus, WindowLostFocus.

С:
1.0
См. также:
WindowEvent, Window.addWindowListener(java.awt.event.WindowListener), Сериализованная форма

Вложенные классы

Модификатор и тип Класс Описание
protected class  Dialog.AccessibleAWTDialog

Этот класс реализует поддержку доступности для класса Dialog.

static class  Dialog.ModalExclusionType

Любое окно верхнего уровня может быть помечено как не блокируемое модальными диалогами.
static class  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

Сводка полей

Модификатор и тип Поле Описание
static Dialog.ModalityType DEFAULT_MODALITY_TYPE

Тип модальности по умолчанию для модальных диалогов.

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

Сводка конструкторов

Конструктор Описание
Dialog​(Dialog owner)

Создаёт начальное невидимое, безимпульсное диалоговое окно с указанным владельцем Dialog и пустым заголовком.
Dialog​(Dialog owner, String title)

Создаёт начальное невидимое, безимпульсное диалоговое окно с указанным владельцем Dialog и заголовком.
Dialog​(Dialog owner, String title, boolean modal)

Создаёт начальное невидимое диалоговое окно с указанным владельцем Dialog, заголовком и типом модальности.
Dialog​(Dialog owner, String title, boolean modal, GraphicsConfiguration gc)

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

Dialog​(Frame owner)

Создаёт начальное невидимое, безимпульсное диалоговое окно с указанным владельцем Frame и пустым заголовком.
Dialog​(Frame owner, boolean modal)

Создаёт начальное невидимое диалоговое окно с указанным владельцем Frame и типом модальности и пустым заголовком.
Dialog​(Frame owner, String title)

Создаёт начальное невидимое, безимпульсное диалоговое окно с указанным владельцем Frame и заголовком.
Dialog​(Frame owner, String title, boolean modal)

Создаёт начальное невидимое диалоговое окно с указанным владельцем Frame, заголовком и типом модальности.
Dialog​(Frame owner, String title, boolean modal, GraphicsConfiguration gc)

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

Dialog​(Window owner)

Создаёт начальное невидимое, безимпульсное диалоговое окно с указанным владельцем Window и пустым заголовком.
Dialog​(Window owner, Dialog.ModalityType modalityType)

Создаёт начальное невидимое диалоговое окно с указанным владельцем Window и типом модальности и пустым заголовком.
Dialog​(Window owner, String title)

Создаёт начальное невидимое, безимпульсное диалоговое окно с указанным владельцем Window и заголовком.
Dialog​(Window owner, String title, Dialog.ModalityType modalityType)

Создаёт начальное невидимое диалоговое окно с указанным владельцем Window, заголовком и типом модальности.
Dialog​(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)

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

Методы

Модификатор и тип Метод Описание
void addNotify()

Делает этот Dialog отображаемым, подключив его к ресурсу экрана.
AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим Dialog.
Dialog.ModalityType getModalityType()

Возвращает тип модальности этого диалогового окна.
String getTitle()

Получает заголовок диалогового окна.
void hide()

Устаревшее.

Начиная с JDK версии 1.5, заменено на setVisible(boolean).
boolean isModal()

Указывает, является ли диалоговое окно модальным.
boolean isResizable()

Указывает, можно ли пользователю изменять размер этого диалогового окна.
boolean isUndecorated()

Указывает, является ли это диалоговое окно без декораций.
protected String paramString()

Возвращает строку, представляющую состояние этого диалогового окна.
void setModal​(boolean modal)

Указывает, должно ли это диалоговое окно быть модальным.
void setModalityType​(Dialog.ModalityType type)

Устанавливает тип модальности для этого диалогового окна.
void setResizable​(boolean resizable)

Устанавливает, можно ли пользователю изменять размер этого диалогового окна.
void setTitle​(String title)

Устанавливает заголовок Dialog.
void setUndecorated​(boolean undecorated)

Отключает или включает декорации для этого диалогового окна.
void setVisible​(boolean b)

Отображает или скрывает это Dialog в зависимости от значения параметра b.
void show()

Устаревшее.

Начиная с JDK версии 1.5, заменено на setVisible(boolean).
void 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, processWindowEvent, 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, addImpl, 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, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, 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, getGraphics, 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, 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

Поля

DEFAULT_MODALITY_TYPE

public static final Dialog.ModalityType DEFAULT_MODALITY_TYPE

Тип модальности по умолчанию для модальных диалоговых окон. Тип модальности по умолчанию — APPLICATION_MODAL. Вызов устаревшего setModal(true) эквивалентен setModalityType(DEFAULT_MODALITY_TYPE).

С версии:
1.6
См. также:
Dialog.ModalityType, setModal(boolean)

Конструкторы

Dialog

public Dialog(Frame owner)

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

Параметры:
owner - владелец диалогового окна или null, если у этого диалогового окна нет владельца
Исключения:
IllegalArgumentException - если owner GraphicsConfiguration не принадлежит экранному устройству
HeadlessException - когда GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Dialog

public Dialog(Frame owner,
              boolean modal)

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

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

Dialog

public Dialog(Frame owner,
              String title)

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

Параметры:
owner - владелец диалогового окна или null, если у этого диалогового окна нет владельца
title - заголовок диалогового окна или null, если у этого диалогового окна нет заголовка
Исключения:
IllegalArgumentException - если owner GraphicsConfiguration не принадлежит экранному устройству
HeadlessException - когда GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Dialog

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

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

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

Dialog

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

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

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

Dialog

public Dialog(Dialog owner)

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

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

Dialog

public Dialog(Dialog owner,
              String title)

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

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

Dialog

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

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

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

Dialog

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

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

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

Dialog

public Dialog(Window owner)

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

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

Dialog

public Dialog(Window owner,
              String title)

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

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

Dialog

public Dialog(Window owner,
              Dialog.ModalityType modalityType)

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

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

Dialog

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

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

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

Dialog

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

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

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

Методы

addNotify

public void addNotify()

Делает этот диалог отображаемым, подключив его к ресурсу нативного экрана. Делание диалога отображаемым приведет к отображению всех его дочерних элементов. Этот метод вызывается внутри инструментария и не должен вызываться программами напрямую.

Переопределяет:
addNotify в классе Window
См. также:
Component.isDisplayable(), Container.removeNotify()

isModal

public boolean isModal()

Указывает, является ли диалог модальным.

Этот метод устарел и сохраняется только для обратной совместимости. Используйте getModalityType() вместо него.

Возвращает:
true , если это окно диалога модальное; false в противном случае
См. также:
DEFAULT_MODALITY_TYPE, Dialog.ModalityType.MODELESS, setModal(boolean), getModalityType(), setModalityType(java.awt.Dialog.ModalityType)

setModal

public void setModal(boolean modal)

Указывает, должен ли этот диалог быть модальным.

Этот метод устарел и сохраняется только для обратной совместимости. Используйте setModalityType() вместо него.

Примечание: изменение модальности видимого диалога может не иметь эффекта до тех пор, пока он не будет скрыт, а затем снова показан.

Параметры:
modal — определяет, блокирует ли диалог вход в другие окна при отображении; вызов setModal(true) эквивалентен setModalityType(Dialog.DEFAULT_MODALITY_TYPE), а вызов setModal(false) эквивалентен setModalityType(Dialog.ModalityType.MODELESS)
С:
1.1
См. также:
DEFAULT_MODALITY_TYPE, Dialog.ModalityType.MODELESS, isModal(), getModalityType(), setModalityType(java.awt.Dialog.ModalityType)

getModalityType

public Dialog.ModalityType getModalityType()

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

Возвращает:
тип модальности этого диалога
С:
1.6
См. также:
setModalityType(java.awt.Dialog.ModalityType)

setModalityType

public void setModalityType(Dialog.ModalityType type)

Устанавливает тип модальности для этого диалога. См. ModalityType для возможных типов модальности.

Если заданный тип модальности не поддерживается, используется MODELESS. Вы можете вызвать getModalityType() после вызова этого метода, чтобы убедиться, что тип модальности был установлен.

Примечание: изменение модальности видимого диалога может не иметь эффекта до тех пор, пока он не будет скрыт, а затем снова показан.

Параметры:
type — определяет, блокирует ли диалог вход в другие окна при отображении. null значение и неподдерживаемые типы модальности эквивалентны MODELESS
Исключения:
SecurityException — если поток вызова не имеет разрешения на создание модальных диалогов с заданным modalityType
С:
1.6
См. также:
getModalityType(), Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)

getTitle

public String getTitle()

Получает заголовок диалога. Заголовок отображается в рамке диалога.

Возвращает:
заголовок этого окна диалога. Заголовок может быть null.
См. также:
setTitle(java.lang.String)

setTitle

public void setTitle(String title)

Устанавливает заголовок диалога.

Параметры:
title — заголовок, отображаемый в рамке диалога; значение null приводит к пустому заголовку
См. также:
getTitle()

setVisible

public void setVisible(boolean b)

Отображает или скрывает этот Dialog, в зависимости от значения параметра b.

Переопределяет:
setVisible в классе Window
Параметры:
b — если true, делает Dialog видимым, в противном случае скрывает Dialog. Если диалог и/или его владелец еще не отображаемы, оба делаются отображаемыми. Диалог будет валидирован перед отображением. Если false, скрывает Dialog и вызывает setVisible(true) если он в настоящее время заблокирован.

Примечания для модальных диалогов.

  • setVisible(true): Если диалог еще не виден, этот вызов не вернет значение, пока диалог не будет скрыт путем вызова setVisible(false) или dispose.
  • setVisible(false): Скрывает диалог и возвращает значение по setVisible(true) если он в настоящее время заблокирован.
  • Вызов этого метода из потока обработки событий допустим, так как инструментарий гарантирует, что другие события не будут заблокированы, пока этот метод заблокирован.
См. также:
Window.setVisible(boolean), Window.dispose(), Component.isDisplayable(), Component.validate(), isModal()

show

@Deprecated
public void show()
Устарело.
Начиная с JDK версии 1.5, заменено на setVisible(boolean).

Делает Dialog видимым. Если диалог и/или его владелец еще не отображаемы, оба делаются отображаемыми. Диалог будет валидирован перед отображением. Если диалог уже виден, это приведет к выводу диалога на передний план.

Если диалог модальный и еще не виден, этот вызов не вернет значение, пока диалог не будет скрыт вызовом hide или dispose. Допускается показ модальных диалогов из потока обработки событий, поскольку инструментарий гарантирует запуск другого цикла обработки событий, в то время как цикл, вызвавший этот метод, заблокирован.

Переопределяет:
show в классе Window
См. также:
Component.hide(), Component.isDisplayable(), Component.validate(), isModal(), Window.setVisible(boolean)

hide

@Deprecated
public void hide()
Устарело.
Начиная с JDK версии 1.5, заменено на setVisible(boolean).

Скрывает диалог и возвращает значение по show если он в настоящее время заблокирован.

Переопределяет:
hide в классе Window
См. также:
Window.show(), Window.dispose(), Window.setVisible(boolean)

toBack

public void toBack()

Если это окно видимое, отправляет это окно назад и может привести к потере фокуса или активации, если это фокусированное или активное окно.

Размещает это окно внизу порядка стекирования и отображает его позади всех других окон в этой виртуальной машине. Действия не будут выполнены, если это окно не отображается. Некоторые платформы не позволяют окнам, принадлежащим другим окнам, отображаться ниже своих владельцев. Будет предпринята попытка переместить это окно как можно ниже в порядке стекирования; однако разработчики не должны предполагать, что этот метод переместит это окно ниже всех других окон в любой ситуации.

Из-за различий в нативных системах окон невозможно гарантировать изменения в фокусированном и активном окнах. Разработчики никогда не должны предполагать, что это окно больше не является фокусированным или активным, пока это окно не получит событие WINDOW_LOST_FOCUS или WINDOW_DEACTIVATED. На платформах, где верхнее окно является фокусированным, этот метод, скорее всего, приведет к потере фокуса этим окном. В этом случае фокус получит следующее вышестоящее фокусируемое окно в этой виртуальной машине. На платформах, где порядок стекирования обычно не влияет на фокусированное окно, этот метод, скорее всего, оставит фокусированное и активное окна без изменений.

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

Переопределяет:
toBack в классе Window
См. также:
Window.toBack()

isResizable

public boolean isResizable()

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

Возвращает:
true , если пользователь может изменить размер диалога; false в противном случае.
См. также:
setResizable(boolean)

setResizable

public void setResizable(boolean resizable)

Устанавливает возможность изменения размера этого диалога пользователем.

Параметры:
resizable — true , если пользователь может изменить размер этого диалога; false в противном случае.
См. также:
isResizable()

setUndecorated

public void setUndecorated(boolean undecorated)

Отключает или включает декорации для этого диалога.

Этот метод может вызываться только в то время, когда диалог не отображается. Чтобы сделать этот диалог декорированным, он должен быть непрозрачным и иметь стандартную форму, в противном случае будет выброшено IllegalComponentStateException. Обратитесь к Window.setShape(java.awt.Shape), Window.setOpacity(float) и Window.setBackground(java.awt.Color) для получения подробностей.

Параметры:
undecorated - true если декорации диалога не должны быть включены; false если декорации диалога должны быть включены
Исключения:
IllegalComponentStateException - если диалог отображается
IllegalComponentStateException - если undecorated имеет значение false, и этот диалог не имеет стандартной формы
IllegalComponentStateException - если undecorated имеет значение false, и непрозрачность этого диалога меньше 1.0f
IllegalComponentStateException - если undecorated имеет значение false, и альфа-значение цвета фона этого диалога меньше 1.0f
С:
1.4
См. также:
isUndecorated(), Component.isDisplayable(), Window.getShape(), Window.getOpacity(), Window.getBackground()

isUndecorated

public boolean isUndecorated()

Указывает, является ли этот диалог без декораций. По умолчанию все диалоги изначально декорированы.

Возвращает:
true если диалог без декораций; false в противном случае.
С:
1.4
См. также:
setUndecorated(boolean)

paramString

protected String paramString()

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

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

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/java/awt/Dialog.html

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