Класс Dialog

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Dialog

Все реализованные интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible

Непосредственные подклассы:: FileDialog, JDialog

public class Dialog extends Window

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

По умолчанию для диалогового окна используется компоновка BorderLayout.

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

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

В многоэкранной среде вы можете создать диалоговое окно Dialog на другом экране, отличном от экрана владельца. Подробности см. в Frame.

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

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

С момента:

1.0

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`Dialog.AccessibleAWTDialog`	Этот класс реализует поддержку доступности для класса `Dialog`.
`static enum`	`Dialog.ModalExclusionType`	Любое окно верхнего уровня может быть помечено как не заблокированное диалоговыми окнами-модальностями.
`static enum`	`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 final 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()`	Делает это диалоговое окно отображаемым, подключив его к ресурсу экрана.
`AccessibleContext`	`getAccessibleContext()`	Получает AccessibleContext, связанный с этим диалоговым окном.
`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)`	Устанавливает заголовок диалогового окна.
`void`	`setUndecorated(boolean undecorated)`	Отключает или включает украшения для этого диалогового окна.
`void`	`setVisible(boolean b)`	Отображает или скрывает это диалоговое окно в зависимости от значения параметра `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

public Dialog(Frame owner)

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

Параметры:

owner - владелец диалогового окна или null если у этого диалогового окна нет владельца

Исключения:

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

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

См. также:

Dialog

public Dialog(Frame owner, boolean modal)

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

Параметры:

owner - владелец диалогового окна или null если у этого диалогового окна нет владельца

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

Исключения:

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

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

См. также:

Dialog

public Dialog(Frame owner, String title)

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

Параметры:

owner - владелец диалогового окна или null если у этого диалогового окна нет владельца

title - заголовок диалогового окна или null если у этого диалогового окна нет заголовка

Исключения:

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

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

См. также:

Dialog

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

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

Параметры:

owner - владелец диалогового окна или null если у этого диалогового окна нет владельца

title - заголовок диалогового окна или null если у этого диалогового окна нет заголовка

Исключения:

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

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

См. также:

Dialog

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

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

Параметры:

owner - владелец диалогового окна или null если у этого диалогового окна нет владельца

title - заголовок диалогового окна или null если у этого диалогового окна нет заголовка

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

Исключения:

IllegalArgumentException - если gc не принадлежит экрану

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

С:

1.4

См. также:

Dialog

public Dialog(Dialog owner)

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

Параметры:

owner - владелец диалогового окна или null если у этого диалогового окна нет владельца

Исключения:

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

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

С:

1.2

См. также:

Dialog

public Dialog(Dialog owner, String title)

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

Параметры:

owner - владелец диалогового окна или null если у этого диалогового окна нет владельца

title - заголовок диалогового окна или null если у этого диалогового окна нет заголовка

Исключения:

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

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

С:

1.2

См. также:

Диалог

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

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

Параметры:

owner - владелец диалога или null если у этого диалога нет владельца

title - заголовок диалога или null если у этого диалога нет заголовка

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

Исключения:

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

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

С:

1.2

См. также:

Диалог

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

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

Параметры:

owner - владелец диалога или null если у этого диалога нет владельца

title - заголовок диалога или null если у этого диалога нет заголовка

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

Исключения:

IllegalArgumentException - если gc не из устройства экрана

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

С:

1.4

См. также:

Диалог

public Dialog(Window owner)

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

Параметры:

owner - владелец диалога. Владелец должен быть экземпляром Dialog, Frame, или их потомков или null

Исключения:

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

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

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

С:

1.6

См. также:

Диалог

public Dialog(Window owner, String title)

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

Параметры:

owner - владелец диалога. Владелец должен быть экземпляром Dialog, Frame, или их потомков или null

title - заголовок диалога или null если у этого диалога нет заголовка

Исключения:

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

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

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

С:

1.6

См. также:

Диалог

public Dialog(Window owner, Dialog.ModalityType modalityType)

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

Параметры:

owner - владелец диалога. Владелец должен быть экземпляром Dialog, Frame, или их потомков или null

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

Исключения:

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

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

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

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

С:

1.6

См. также:

Диалог

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

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

Параметры:

owner - владелец диалога. Владелец должен быть экземпляром Dialog, Frame, или их потомков или null

title - заголовок диалога или null если у этого диалога нет заголовка

Исключения:

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

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

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

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

С:

1.6

См. также:

Диалог

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

Создаёт начально невидимый Dialog с указанным владельцем 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

См. также:

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

addNotify

public void addNotify()

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

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

addNotify в классе Window

См. также:

isModal

public boolean isModal()

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

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

Возвращает:

true если это модальное диалоговое окно; false в противном случае

См. также:

setModal

public void setModal(boolean modal)

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

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

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

Параметры:

modal - указывает, блокирует ли диалоговое окно ввод в другие окна при отображении; вызов для setModal(true) эквивалентен setModalityType(Dialog.DEFAULT_MODALITY_TYPE), а вызов для setModal(false) эквивалентен setModalityType(Dialog.ModalityType.MODELESS)

С:

1.1

См. также:

getModalityType

public Dialog.ModalityType getModalityType()

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

Возвращает:

тип модальности этого диалогового окна

С:

1.6

См. также:

setModalityType

public void setModalityType(Dialog.ModalityType type)

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

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

Параметры:

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

Исключения:

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

С:

1.6

См. также:

getTitle

public String getTitle()

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

Возвращает:

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

См. также:

setTitle

public void setTitle(String title)

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

Параметры:

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

См. также:

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) если он в настоящее время заблокирован.
Разрешается вызывать этот метод из потока обработки событий, так как инструментарий гарантирует, что другие события не будут заблокированы, пока этот метод заблокирован.

См. также:

show

@Deprecated public void show()

Устарел.

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

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

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

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

show в классе Window

См. также:

Скрыть

@Deprecated public void hide()

Устарело.

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

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

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

hide в классе Window

См. также:

toBack

public void toBack()

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

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

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

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

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

toBack в классе Window

См. также:

isResizable

public boolean isResizable()

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

Возвращает:

true если пользователь может изменить размер диалогового окна; false в противном случае.

См. также:

setResizable

public void setResizable(boolean resizable)

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

Параметры:

resizable - true если пользователь может изменить размер этого диалогового окна; false в противном случае.

См. также:

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

public boolean isUndecorated()

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

Возвращает:

true если диалоговое окно без декораций; false в противном случае.

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

1.4

См. также:

paramString

protected String paramString()

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

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

© 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/java/awt/Dialog.html