Spec-Zone.ru › OpenJDK 24

Класс 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.

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

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

Модификатор и тип Класс Описание
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(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()
Делает этот Dialog отображаемым, подключив его к ресурсу нативном экране.
AccessibleContext getAccessibleContext()
Получает AccessibleContext, связанный с этим Dialog.
Dialog.ModalityType getModalityType()
Возвращает тип режима этого диалога.
String getTitle()
Получает заголовок диалога.
void hide()
Устарело.
С версии JDK 1.5 заменено на setVisible(boolean).
boolean isModal()
Указывает, является ли диалог модальным.
boolean isResizable()
Указывает, может ли пользователь изменять размер этого диалога.
boolean isUndecorated()
Указывает, является ли этот диалог без декораций.
protected String paramString()
Возвращает строку, представляющую состояние этого диалога.
void setModal(boolean modal)
Указывает, должен ли этот диалог быть модальным.
void setModalityType(Dialog.ModalityType type)
Устанавливает тип режима для этого диалога.
void setResizable(boolean resizable)
Устанавливает, может ли пользователь изменять размер этого диалога.
void setTitle(String title)
Устанавливает заголовок Dialog.
void setUndecorated(boolean undecorated)
Отключает или включает декорации для этого диалога.
void setVisible(boolean b)
Отображает или скрывает это Dialog в зависимости от значения параметра b.
void show()
Устарело.
С версии JDK 1.5 заменено на setVisible(boolean).
void toBack()
Если это Window видимо, отправляет это Window назад и может привести к потере фокуса или активации, если это фокусированное или активное Window.

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

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBackground, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setOpacity, setShape, setSize, setSize, setType, toFront

Методы, объявленные в классе java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание полей

DEFAULT_MODALITY_TYPE

public static final Dialog.ModalityType DEFAULT_MODALITY_TYPE
Тип модального диалога по умолчанию. Тип по умолчанию — APPLICATION_MODAL. Вызов старого стиля setModal(true) эквивалентен setModalityType(DEFAULT_MODALITY_TYPE).
С момента:
1.6
См. также:
  • Dialog.ModalityType
  • setModal(boolean)

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

Dialog

public Dialog(Frame owner)
Создает невидимый по умолчанию, бескомпонентый Dialog с указанным владельцем Frame и пустым заголовком.
Параметры:
owner - владелец диалога или null, если у этого диалога нет владельца
Исключения:
IllegalArgumentException - если owner's 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's 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's 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's 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
С момента:
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's GraphicsConfiguration не из устройства экрана
HeadlessException - когда GraphicsEnvironment.isHeadless() возвращает true
С момента:
1.2
См. также:
  • GraphicsEnvironment.isHeadless()

Dialog

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

Диалог

public Dialog(Dialog owner, String title, boolean modal, GraphicsConfiguration gc)
Создаёт начально невидимый диалог с указанным владельцем, заголовком, модальностью и конфигурацией графики.
Параметры:
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)

Диалог

public Dialog(Window owner)
Создаёт начально невидимый, безалиасный диалог с указанным владельцем и пустым заголовком.
Параметры:
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)
Создаёт начально невидимый, безалиасный диалог с указанным владельцем и заголовком.
Параметры:
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)
Создаёт начально невидимый диалог с указанным владельцем и типом модальности и пустым заголовком.
Параметры:
owner - владелец диалога. Владелец должен быть экземпляром Dialog, Frame, или любого их потомка или null
modalityType - указывает, блокирует ли диалог ввод в других окнах при отображении. null значение и неподдерживаемые типы модальности эквивалентны MODELESS
Исключения:
IllegalArgumentException - если owner не является экземпляром Dialog или Frame
IllegalArgumentException - если owner's GraphicsConfiguration не принадлежит экрану
HeadlessException - когда GraphicsEnvironment.isHeadless() возвращает true
С:
1.6
См. также:
  • Dialog.ModalityType
  • setModal(boolean)
  • setModalityType(java.awt.Dialog.ModalityType)
  • GraphicsEnvironment.isHeadless()
  • Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)

Диалог

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

Диалог

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

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

addNotify

public void addNotify()
Делает этот диалог отображаемым, подключив его к ресурсу нативному экрану. Делание диалога отображаемым приведет к отображению всех его дочерних элементов. Этот метод вызывается внутри инструментария и не должен вызываться напрямую программами.
Переопределяет:
addNotify в классе Window
См. также:
  • Component.isDisplayable()
  • Container.removeNotify()

isModal

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

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

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

setModal

public void setModal(boolean modal)
Указывает, должен ли этот диалог быть модальным.

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

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

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

getModalityType

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

setModalityType

public void setModalityType(Dialog.ModalityType type)
Устанавливает тип модальности для этого диалога. См. ModalityType для возможных типов модальности.

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

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

Параметры:
type - указывает, блокирует ли диалог ввод в другие окна при отображении. null значение и неподдерживаемые типы модальности эквивалентны MODELESS
С:
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)

Скрыть

@Deprecated public void hide()
Устаревший.
Начиная с версии JDK 1.5, заменён на setVisible(boolean).
Скрывает диалоговое окно и затем вызывает show, если оно в настоящее время заблокировано.
Переопределяет:
hide в классе Window
См. также:
  • Window.show()
  • Window.dispose()
  • Window.setVisible(boolean)

toBack

public void toBack()
Если это окно отображается, перемещает это окно в конец стека и может привести к потере фокуса или активации, если это окно с фокусом или активное окно.

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

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

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

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

isResizable

public boolean isResizable()
Указывает, может ли пользователь изменить размер этого диалогового окна. По умолчанию все диалоговые окна изначально могут быть изменены в размерах.
Возвращает:
true, если пользователь может изменить размер диалогового окна; false в противном случае.
См. также:
  • setResizable(boolean)

setResizable

public void setResizable(boolean resizable)
Устанавливает, может ли пользователь изменять размер этого диалогового окна.
Параметры:
resizable - true, если пользователь может изменять размер этого диалогового окна; false в противном случае.
См. также:
  • isResizable()

setUndecorated

public void setUndecorated(boolean undecorated)
Отключает или включает декорации для этого диалогового окна.

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

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

isUndecorated

public boolean isUndecorated()
Указывает, является ли это диалоговое окно без декораций. По умолчанию все диалоговые окна изначально имеют декорации.
Возвращает:
true, если диалоговое окно без декораций; false в противном случае.
С:
1.4
См. также:
  • setUndecorated(boolean)

paramString

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

getAccessibleContext

public AccessibleContext getAccessibleContext()
Получает AccessibleContext, связанный с этим диалоговым окном. Для диалоговых окон AccessibleContext принимает вид AccessibleAWTDialog. Новый экземпляр AccessibleAWTDialog создаётся при необходимости.
Указывается:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Window
Возвращает:
AccessibleAWTDialog, который служит AccessibleContext для этого диалогового окна
С:
1.3

© 1993, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/Dialog.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API