Класс 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 Modality AWT Модальность.

Диалоговые окна могут генерировать следующие 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)

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

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

Параметры:

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

Исключения:

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

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

С момента:

1.2

См. также:

GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Dialog owner, String title)

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

Параметры:

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

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

Исключения:

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

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

С момента:

1.2

См. также:

GraphicsEnvironment.isHeadless()

Диалог

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

См. также:

GraphicsEnvironment.isHeadless()

Диалог

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

См. также:

GraphicsEnvironment.isHeadless()

Диалог

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

См. также:

Dialog

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

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

Parameters:

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

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

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

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

Throws:

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

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

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

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

Since:

1.6

See Also:

Методы

addNotify

public void addNotify()

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

Overrides:

addNotify в классе Window

See Also:

isModal

public boolean isModal()

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

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

Returns:

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

See Also:

DEFAULT_MODALITY_TYPE
Dialog.ModalityType.MODELESS
setModal(boolean)
getModalityType()
setModalityType(java.awt.Dialog.ModalityType)

setModal

public void setModal(boolean modal)

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

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

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

Parameters:

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

Since:

1.1

See Also:

DEFAULT_MODALITY_TYPE
Dialog.ModalityType.MODELESS
isModal()
getModalityType()
setModalityType(java.awt.Dialog.ModalityType)

getModalityType

public Dialog.ModalityType getModalityType()

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

Returns:

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

Since:

1.6

See Also:

setModalityType(java.awt.Dialog.ModalityType)

setModalityType

public void setModalityType(Dialog.ModalityType type)

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

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

Parameters:

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

Throws:

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

Since:

1.6

See Also:

getTitle

public String getTitle()

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

Returns:

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

See Also:

setTitle(java.lang.String)

setTitle

public void setTitle(String title)

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

Parameters:

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

See Also:

getTitle()

setVisible

public void setVisible(boolean b)

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

Overrides:

setVisible в классе Window

Parameters:

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

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

setVisible(true): Если диалоговое окно ещё не отображается, этот вызов не вернётся до тех пор, пока диалоговое окно не будет скрыто вызовом setVisible(false) или dispose.
setVisible(false): Скрывает диалоговое окно и возвращается при setVisible(true) если оно в данный момент заблокировано.
Разрешено вызывать этот метод из потока обработки событий, так как среда выполнения обеспечивает, что другие события не блокируются, в то время как этот метод заблокирован.

See Also:

show

@Deprecated public void show()

Устарел.

С версии JDK 1.5 заменён на setVisible(boolean).

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

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

Overrides:

show в классе Window

See Also:

hide

@Deprecated public void hide()

Устарело.

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

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

Overrides:

hide в классе Window

См. также:

toBack

public void toBack()

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

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

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

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

Overrides:

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

public boolean isUndecorated()

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

Возвращает:

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

С:

1.4

См. также:

setUndecorated(boolean)

paramString

protected String paramString()

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

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

© 1993, 2021, 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/17/docs/api/java.desktop/java/awt/Dialog.html