Класс 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, однако, поскольку они зависят от платформы, корректное значение insets нельзя получить, пока диалог не станет отображаемым после вызова pack или show. Поскольку область рамки включена в общий размер диалога, рамка фактически закрывает часть диалога, ограничивая область, доступную для отрисовки и/или отображения подкомпонентов, прямоугольником с координатами верхнего левого угла (insets.left, insets.top) и размерами width - (insets.left + insets.right) на height - (insets.top + insets.bottom).

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

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

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

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

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

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

Начиная с версии:

1.0

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`Dialog.AccessibleAWTDialog`	Этот класс реализует поддержку специальных возможностей для класса `Dialog`.
`static enum`	`Dialog.ModalExclusionType`	Любое окно верхнего уровня можно пометить так, чтобы модальные диалоги не блокировали его.
`static enum`	`Dialog.ModalityType`	Модальные диалоги блокируют весь ввод в некоторые окна верхнего уровня.

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

Window.AccessibleAWTWindow, Window.Type

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

Container.AccessibleAWTContainer

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final Dialog.ModalityType`	`DEFAULT_MODALITY_TYPE`	Тип модальности по умолчанию для модальных диалогов.

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

Конструктор	Описание
`Dialog(Dialog owner)`	Создаёт изначально невидимый немодальный `Dialog` с указанным владельцем `Dialog` и пустым заголовком.
`Dialog(Dialog owner, String title)`	Создаёт изначально невидимый немодальный `Dialog` с указанным владельцем `Dialog` и заголовком.
`Dialog(Dialog owner, String title, boolean modal)`	Создаёт изначально невидимый `Dialog` с указанным владельцем `Dialog`, заголовком и типом модальности.
`Dialog(Dialog owner, String title, boolean modal, GraphicsConfiguration gc)`	Создаёт изначально невидимый `Dialog` с указанным владельцем `Dialog`, заголовком, типом модальности и `GraphicsConfiguration`.
`Dialog(Frame owner)`	Создаёт изначально невидимый немодальный `Dialog` с указанным владельцем `Frame` и пустым заголовком.
`Dialog(Frame owner, boolean modal)`	Создаёт изначально невидимый `Dialog` с указанным владельцем `Frame`, типом модальности и пустым заголовком.
`Dialog(Frame owner, String title)`	Создаёт изначально невидимый немодальный `Dialog` с указанным владельцем `Frame` и заголовком.
`Dialog(Frame owner, String title, boolean modal)`	Создаёт изначально невидимый `Dialog` с указанным владельцем `Frame`, заголовком и типом модальности.
`Dialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)`	Создаёт изначально невидимый `Dialog` с указанным владельцем `Frame`, заголовком, типом модальности и `GraphicsConfiguration`.
`Dialog(Window owner)`	Создаёт изначально невидимый немодальный `Dialog` с указанным владельцем `Window` и пустым заголовком.
`Dialog(Window owner, Dialog.ModalityType modalityType)`	Создаёт изначально невидимый `Dialog` с указанным владельцем `Window`, типом модальности и пустым заголовком.
`Dialog(Window owner, String title)`	Создаёт изначально невидимый немодальный `Dialog` с указанным владельцем `Window` и заголовком.
`Dialog(Window owner, String title, Dialog.ModalityType modalityType)`	Создаёт изначально невидимый `Dialog` с указанным владельцем `Window`, заголовком и типом модальности.
`Dialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)`	Создаёт изначально невидимый `Dialog` с указанным владельцем `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)`	Показывает или скрывает этот `Dialog` в зависимости от значения параметра `b`.
`void`	`show()`	Устарел. Начиная с JDK версии 1.5 заменён методом `setVisible(boolean)`.
`void`	`toBack()`	Если это окно видимо, перемещает его на задний план и может привести к потере фокуса или активности, если оно находится в фокусе или является активным окном.

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

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, 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

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

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

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

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

Параметры:

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

Исключения:

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

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

См. также:

Dialog

public Dialog(Frame owner, boolean modal)

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

Dialog

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

Dialog

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

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

Параметры:

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

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

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

Исключения:

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

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

Начиная с:

1.4

См. также:

Dialog

public Dialog(Dialog owner)

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

Параметры:

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

Исключения:

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

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

Начиная с:

1.2

См. также:

Dialog

public Dialog(Dialog owner, String title)

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

Параметры:

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

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

Исключения:

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

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

Начиная с:

1.2

См. также:

Dialog

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

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

Параметры:

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

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

Исключения:

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

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

Начиная с:

1.2

См. также:

Dialog

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

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

Параметры:

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

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

Исключения:

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

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

Начиная с:

1.4

См. также:

Dialog

public Dialog(Window owner)

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

Параметры:

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

Исключения:

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

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

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

Начиная с:

1.6

См. также:

Dialog

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

См. также:

Dialog

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

Начиная с:

1.6

См. также:

Dialog

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

Начиная с:

1.6

См. также:

Dialog

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

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

Параметры:

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

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

Исключения:

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

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

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

Начиная с:

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

Начиная с:

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

См. также:

hide

@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(Shape), Window.setOpacity(float) и Window.setBackground(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, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/Dialog.html