Класс 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 Модальность по ссылке.

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

С:: JDK1.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(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`	`setBackground(Color bgColor)` Устанавливает цвет фона этого окна.
`void`	`setModal(boolean modal)` Указывает, должен ли этот диалог быть модальным.
`void`	`setModalityType(Dialog.ModalityType type)` Устанавливает тип модальности для этого диалога.
`void`	`setOpacity(float opacity)` Устанавливает непрозрачность окна.
`void`	`setResizable(boolean resizable)` Устанавливает, можно ли изменять размер этого диалога пользователем.
`void`	`setShape(Shape shape)` Устанавливает форму окна.
`void`	`setTitle(String title)` Устанавливает заголовок диалога.
`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, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, 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, 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, getPeer, 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, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, 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).

Since:: 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(), Component.setSize(int, int), Component.setVisible(boolean)

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
Since:: 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
Since:: 1.2
См. также:: GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Dialog owner,
              String title)

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

Параметры:: owner - владелец диалога или null , если у этого диалога нет владельца; title - заголовок диалога или null , если у этого диалога нет заголовка
Исключения:: IllegalArgumentException - если owner владельца GraphicsConfiguration не с экрана устройства; HeadlessException - когда GraphicsEnvironment.isHeadless() возвращает true
Since:: 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
Since:: 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(), Window.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)

setOpacity

public void setOpacity(float opacity)

Устанавливает непрозрачность окна.

Значение непрозрачности находится в диапазоне [0..1]. Обратите внимание, что установка уровня непрозрачности 0 может или не может отключить обработку событий мыши в этом окне. Это зависит от платформы.

Для установки значения непрозрачности меньше 1.0f, должны быть выполнены следующие условия:

Прозрачность TRANSLUCENT должна поддерживаться основной системой.
Окно должно быть без декораций (см. Frame.setUndecorated(boolean) и setUndecorated(boolean))
Окно не должно быть в полноэкранном режиме (см. GraphicsDevice.setFullScreenWindow(Window))

Если запрошенное значение непрозрачности меньше 1.0f, и любое из вышеперечисленных условий не выполнено, непрозрачность окна не изменится, и будет выброшено исключение IllegalComponentStateException.

Уровни прозрачности отдельных пикселей также могут влиять на альфа-компонент их цвета (см. Window.setBackground(Color)) и текущую форму этого окна (см. Window.setShape(Shape)).

Overrides:: setOpacity в классе Window
Parameters:: opacity - уровень непрозрачности, который нужно установить для окна
See Also:: Window.getOpacity(), Window.setBackground(Color), Window.setShape(Shape), Frame.isUndecorated(), isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)

setShape

public void setShape(Shape shape)

Устанавливает форму окна.

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

Для установки формы, отличной от null, должны быть выполнены следующие условия:

Прозрачность PERPIXEL_TRANSPARENT должна поддерживаться основной системой.
Окно должно быть без декораций (см. Frame.setUndecorated(boolean) и setUndecorated(boolean))
Окно не должно быть в полноэкранном режиме (см. GraphicsDevice.setFullScreenWindow(Window))

Если запрошенная форма не равна null, и любое из вышеперечисленных условий не выполнено, форма этого окна не изменится, и будет выброшено исключение UnsupportedOperationException или IllegalComponentStateException.

Уровни прозрачности отдельных пикселей также могут влиять на альфа-компонент их цвета (см. Window.setBackground(Color)) и значение непрозрачности (см. Window.setOpacity(float)). Дополнительные сведения см. в GraphicsDevice.WindowTranslucency.

Overrides:: setShape в классе Window
Parameters:: shape - форма, которая должна быть установлена для окна
See Also:: Window.getShape(), Window.setBackground(Color), Window.setOpacity(float), Frame.isUndecorated(), isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)

setBackground

public void setBackground(Color bgColor)

Устанавливает цвет фона этого окна.

Если система окон поддерживает прозрачность PERPIXEL_TRANSLUCENT, альфа-компонент заданного цвета фона может повлиять на режим работы этого окна: он указывает, должно ли это окно быть непрозрачным (альфа равна 1.0f) или полупрозрачным на пиксель (альфа меньше 1.0f). Если заданный цвет фона равен null, окно считается полностью непрозрачным.

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

Прозрачность PERPIXEL_TRANSLUCENT должна поддерживаться графическим устройством, на котором расположено это окно.
Окно должно быть без декораций (см. Frame.setUndecorated(boolean) и setUndecorated(boolean)).
Окно не должно быть в полноэкранном режиме (см. GraphicsDevice.setFullScreenWindow(Window)).

Если альфа-компонент запрошенного цвета фона меньше 1.0f, и любое из вышеперечисленных условий не выполнено, цвет фона этого окна не изменится, альфа-компонент заданного цвета фона не повлияет на режим работы этого окна, и будет выброшено исключение UnsupportedOperationException или IllegalComponentStateException.

Когда окно полупрозрачно на пиксель, подсистема рисования учитывает значение альфа каждого отдельного пикселя. Если пиксель рисуется с альфа-компонентом, равным нулю, он становится визуально прозрачным. Если альфа пикселя равна 1.0f, пиксель полностью непрозрачен. Промежуточные значения альфа-компонента цвета делают пиксель полупрозрачным. В этом режиме фон окна рисуется со значением альфа заданного цвета фона. Если значение альфа аргумента этого метода равно 0, фон не рисуется вообще.

Фактический уровень прозрачности данного пикселя также зависит от непрозрачности окна (см. Window.setOpacity(float)), а также от текущей формы этого окна (см. Window.setShape(Shape)).

Обратите внимание, что рисование пикселя с альфа-значением 0 может или не может отключить обработку событий мыши на этом пикселе. Это зависит от платформы. Чтобы убедиться, что события мыши не будут передаваться на конкретный пиксель, пиксель должен быть исключен из формы окна.

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

Overrides:: setBackground в классе Window
Parameters:: bgColor - цвет, который должен стать цветом фона этого окна.
See Also:: Window.getBackground(), Window.isOpaque(), Window.setOpacity(float), Window.setShape(Shape), Frame.isUndecorated(), isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency), GraphicsConfiguration.isTranslucencyCapable()

paramString

protected String paramString()

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

Overrides:: paramString в классе Container
Returns:: строка параметров этого диалогового окна.

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе Window
Returns:: AccessibleAWTDialog, который служит AccessibleContext для этого диалогового окна
Since:: 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.