java.awt

Диалоговое окно класса

java.lang. Объект

java.awt. Компонент

java.awt. Контейнер

java.awt. Окно

java.awt. Диалоговое окно

Все Реализованные Интерфейсы:

ImageObserver, MenuContainer, Сериализуемый, Доступный

Прямые Известные Подклассы:

FileDialog, JDialog

public class Dialog
extends Window

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

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

У диалогового окна могут быть свои собственные художественные оформления (то есть Фрейм & Строка заголовка) выключенный с setUndecorated. Это может только быть сделано, в то время как диалоговое окно не displayable.

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

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

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

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

С тех пор:

JDK1.0

См. Также:

WindowEvent, Window.addWindowListener(java.awt.event.WindowListener), Сериализированная Форма

Вложенная Сводка Класса

Вложенные Классы

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

Вложенные классы/интерфейсы, наследованные от class java.awt. Окно

Window.AccessibleAWTWindow, Window.Type

Вложенные классы/интерфейсы, наследованные от class java.awt. Контейнер

Контейнер. AccessibleAWTContainer

Вложенные классы/интерфейсы, наследованные от class java.awt. Компонент

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

Полевая Сводка

Поля

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

Поля, наследованные от class java.awt. Компонент

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 и пустой title.
Dialog(Dialog owner, String title) Создает первоначально невидимый, немодальный Dialog с указанным владельцем Dialog и title.
Dialog(Dialog owner, String title, boolean modal) Создает первоначально невидимый Dialog с указанным владельцем Dialog, title, и модальность.
Dialog(Dialog owner, String title, boolean modal, GraphicsConfiguration gc) Создает первоначально невидимый Dialog с указанным владельцем Dialog, title, модальность и GraphicsConfiguration.
Dialog(Frame owner) Создает первоначально невидимый, немодальный Dialog с указанным владельцем Frame и пустой title.
Dialog(Frame owner, boolean modal) Создает первоначально невидимый Dialog с указанным владельцем Frame и модальность и пустой title.
Dialog(Frame owner, String title) Создает первоначально невидимый, немодальный Dialog с указанным владельцем Frame и title.
Dialog(Frame owner, String title, boolean modal) Создает первоначально невидимый Dialog с указанным владельцем Frame, title и модальность.
Dialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc) Создает первоначально невидимый Dialog с указанным владельцем Frame, title, модальность, и GraphicsConfiguration.
Dialog(Window owner) Создает первоначально невидимый, немодальный Dialog с указанным владельцем Window и пустой title.
Dialog(Window owner, Dialog.ModalityType modalityType) Создает первоначально невидимый Dialog с указанным владельцем Window и модальность и пустой title.
Dialog(Window owner, String title) Создает первоначально невидимый, немодальный Dialog с указанным владельцем Window и title.
Dialog(Window owner, String title, Dialog.ModalityType modalityType) Создает первоначально невидимый Dialog с указанным владельцем Window, title и модальность.
Dialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc) Создает первоначально невидимый Dialog с указанным владельцем Window, title, модальность и GraphicsConfiguration.

Сводка метода

Модификатор и Тип	Метод и Описание
void	addNotify() Делает это Диалоговое окно визуализуемым, соединяя это с собственным экранным ресурсом.
AccessibleContext	getAccessibleContext() Связали AccessibleContext с этим Диалоговым окном.
Диалоговое окно. ModalityType	getModalityType() Возвращает тип модальности этого диалогового окна.
Строка	getTitle() Получает title диалогового окна.
void	hide() Осуждаемый. С версии 1.5 JDK, замененной 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) Устанавливает title Диалогового окна.
void	setUndecorated(boolean undecorated) Отключает или включает художественным оформлениям для этого диалогового окна.
void	setVisible(boolean b) Шоу или скрывают это Dialog в зависимости от значения параметра b.
void	show() Осуждаемый. С версии 1.5 JDK, замененной setVisible(boolean).
void	toBack() Если это Окно видимо, отправляет это Окно спине и может заставить это терять фокус или активацию, если это - фокусируемое или активное окно.

Методы, наследованные от class java.awt. Окно

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

Методы, наследованные от class java.awt. Контейнер

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

Методы, наследованные от class java.awt. Компонент

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

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

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)

Деталь конструктора

Диалоговое окно

public Dialog(Frame owner)

Создает первоначально невидимый, немодальный Dialog с указанным владельцем Frame и пустой title.

Параметры:

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

Броски:

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

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

См. Также:

GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Диалоговое окно

public Dialog(Frame owner,
              boolean modal)

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

Параметры:

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

modal - specifes, блокирует ли диалоговое окно ввод данных пользователем к другим высокоуровневым окнам когда показано. Если 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()

Диалоговое окно

public Dialog(Frame owner,
              String title)

Создает первоначально невидимый, немодальный Dialog с указанным владельцем Frame и title.

Параметры:

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

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

Броски:

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

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

См. Также:

GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Диалоговое окно

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

Создает первоначально невидимый Dialog с указанным владельцем Frame, title и модальность.

Параметры:

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

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

modal - specifes, блокирует ли диалоговое окно ввод данных пользователем к другим высокоуровневым окнам когда показано. Если 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)

Диалоговое окно

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

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

Параметры:

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

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

modal - specifes, блокирует ли диалоговое окно ввод данных пользователем к другим высокоуровневым окнам когда показано. Если 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(Dialog owner)

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

Параметры:

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

Броски:

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

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

С тех пор:

1.2

См. Также:

GraphicsEnvironment.isHeadless()

Диалоговое окно

public Dialog(Dialog owner,
              String title)

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

Параметры:

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

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

Броски:

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

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

С тех пор:

1.2

См. Также:

GraphicsEnvironment.isHeadless()

Диалоговое окно

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

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

Параметры:

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

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

modal - specifes, блокирует ли диалоговое окно ввод данных пользователем к другим высокоуровневым окнам когда показано. Если 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)

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

Параметры:

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

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

modal - specifes, блокирует ли диалоговое окно ввод данных пользователем к другим высокоуровневым окнам когда показано. Если 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)

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

Параметры:

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 и title.

Параметры:

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

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

Броски:

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 и модальность и пустой title.

Параметры:

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

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

Броски:

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

IllegalArgumentException - если owner's 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)

Диалоговое окно

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

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

Параметры:

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

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

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

Броски:

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

IllegalArgumentException - если owner's 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)

Диалоговое окно

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

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

Параметры:

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

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

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 в class Window

См. Также:

Component.isDisplayable(), Window.removeNotify()

isModal

public boolean isModal()

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

Этот метод является устаревшим и сохраняется для назад compatiblity только. Использовать 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) equvivalent к 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()

Получает title диалогового окна. title выводится на экран в границе диалогового окна.

Возвраты:

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

См. Также:

setTitle(java.lang.String)

setTitle

public void setTitle(String title)

Устанавливает title Диалогового окна.

Параметры:

title - title выводится на экран в границе диалогового окна; нулевое значение приводит к пустому title

См. Также:

getTitle()

setVisible

public void setVisible(boolean b)

Шоу или скрывают это Dialog в зависимости от значения параметра b.

Переопределения:

setVisible в class 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()

показать

@Deprecated
public void show()

Осуждаемый. С версии 1.5 JDK, замененной setVisible(boolean).

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

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

Переопределения:

show в class Window

См. Также:

Component.hide(), Component.isDisplayable(), Component.validate(), isModal(), Window.setVisible(boolean)

скрыться

@Deprecated
public void hide()

Осуждаемый. С версии 1.5 JDK, замененной setVisible(boolean).

Скрывает Диалоговое окно и затем вызывает show возвратиться, если это в настоящий момент блокируется.

Переопределения:

hide в class Window

См. Также:

Window.show(), Window.dispose(), Window.setVisible(boolean)

toBack

public void toBack()

Если это Окно видимо, отправляет это Окно спине и может заставить это терять фокус или активацию, если это - фокусируемое или активное окно.

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

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

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

Переопределения:

toBack в class 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)).

Переопределения:

setOpacity в class Window

Параметры:

opacity - уровень непрозрачности, чтобы установить в окно

См. Также:

Window.getOpacity(), Window.setBackground(Color), Window.setShape(Shape), Frame.isUndecorated(), isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)

setShape

public void setShape(Shape shape)

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

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

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

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

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

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

Переопределения:

setShape в class Window

Параметры:

shape - форма, чтобы установить в окно

См. Также:

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 tranclucency, альфа-компонент данного цвета фона может произвести режим работы для этого окна: это указывает, должно ли это окно быть непрозрачным (альфа равняется 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 май или, возможно, не отключает обработку события от нажатия мыши на этом пикселе. Это - зависимое от платформы поведение. Чтобы удостовериться события от нажатия мыши не становятся диспетчеризированными определенному пикселю, пиксель должен быть исключен из формы окна.

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

Переопределения:

setBackground в class Window

Параметры:

bgColor - цвет, чтобы стать цветом фона этого окна.

См. Также:

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.

Переопределения:

paramString в class Container

Возвраты:

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Определенный:

getAccessibleContext в интерфейсе Accessible

Переопределения:

getAccessibleContext в class Window

Возвраты:

AccessibleAWTDialog, который служит AccessibleContext этого Диалогового окна

С тех пор:

1.3