java.awt
類別 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

Dialog 是一個帶標題和邊界的頂層視窗，邊界一般用於從使用者處獲得某種形式的輸入。Dialog 的大小包括邊界所指定的任何區域。邊界區的維度可以使用 getInsets 方法獲得，但是，由於這些維度是依賴於平臺的，因此只有通過調用 pack 或 show 將 dialog 設置為可顯示的，才能獲得有效的 insets 值。由於 dialog 的總大小包括了邊界區，因此邊界有效地模糊了 dialog 的部分區域，約束了可用於在矩形中呈現或顯示子部件的區域，矩形左上角的位置為 (insets.left, insets.top)，寬度為 width - (insets.left + insets.right)，長度為 height - (insets.top + insets.bottom)。

Dialog 的預設佈局為 BorderLayout。

Dialog 可以使用 setUndecorated 關閉本機裝飾（例如 Frame & Titlebar）。只有在 dialog 不是 displayable 時才能完成此操作。

在建構 dialog 時，dialog 可以擁有另一個視窗作為它自己的視窗。當可見的 dialog 的所有者視窗被最小化時，dialog 會自動隱藏為對使用者不可見。當所有者視窗被還原時，dialog 重新又變為使用者可見的。

在多螢幕環境中，可以在不同於其所有者的螢幕設備上創建 Dialog。有關更多資訊，請參閱 Frame。

dialog 可以是無網要的（預設情況下）或有網要的。有網要的 dialog 會阻止將內容輸入到應用程序中的其他一些頂層視窗中（將此 dialog 創建為其所有者的所有視窗除外）。有關細節，請參閱 AWT Modality 規範。

Dialog 能夠產生以下 WindowEvents：WindowOpened、WindowClosing、WindowClosed、WindowActivated、WindowDeactivated、WindowGainedFocus、WindowLostFocus。

從以下版本開始：

JDK1.0

另請參見：

WindowEvent, Window.addWindowListener(java.awt.event.WindowListener), 序列化表格

巢狀類別摘要

protected class	Dialog.AccessibleAWTDialog 此類別實作對 Dialog 類別的可存取性支持。
static class	Dialog.ModalExclusionType 任何頂層視窗都可以標記為不受網要對話框阻塞。
static class	Dialog.ModalityType 網要對話框阻塞對某些頂層視窗的所有輸入。

從類別 java.awt.Window 繼承的巢狀類別/介面

Window.AccessibleAWTWindow

從類別 java.awt.Container 繼承的巢狀類別/介面

Container.AccessibleAWTContainer

從類別 java.awt.Component 繼承的巢狀類別/介面

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

欄位摘要

static Dialog.ModalityType

DEFAULT_MODALITY_TYPE 有網要 dialog 的預設網要型別。

從類別 java.awt.Component 繼承的欄位

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() 獲取與此 Dialog 有關的 AccessibleContext。
Dialog.ModalityType	getModalityType() 返回此 dialog 的網要型別。
String	getTitle() 獲取 dialog 的標題。
void	hide() 已過時。 從 JDK 版本 1.5 開始，由 setVisible(boolean) 取代。
boolean	isModal() 指出 dialog 是否為有網要的。
boolean	isResizable() 指出此 dialog 是否可以由使用者調整大小。
boolean	isUndecorated() 指出此 dialog 是否未裝飾。
protected String	paramString() 返回表示此 dialog 狀態的字元串。
void	setModal(boolean modal) 指定此 dialog 是否應該是有網要的。
void	setModalityType(Dialog.ModalityType type) 設置此 dialog 的網要型別。
void	setResizable(boolean resizable) 設置此 dialog 是否可以由使用者調整大小。
void	setTitle(String title) 設置 Dialog 的標題。
void	setUndecorated(boolean undecorated) 禁用或啟用此 dialog 的裝飾。
void	setVisible(boolean b) 根據參數 b 的值顯示或隱藏此 Dialog。
void	show() 已過時。 從 JDK 版本 1.5 開始，由 setVisible(boolean) 取代。
void	toBack() 如果此視窗是可視的，則將此視窗置於後方，如果它是焦點視窗或活動視窗，則會導致丟失焦點或活動狀態。

從類別 java.awt.Window 繼承的方法

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOwnedWindows, getOwner, getOwnerlessWindows, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, 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, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, 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, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, 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, isOpaque, 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, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, 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

有網要 dialog 的預設網要型別。預設網要型別是 APPLICATION_MODAL。調用舊式 setModal(true) 等效於調用 setModalityType(DEFAULT_MODALITY_TYPE)。

從以下版本開始：

1.6

另請參見：

Dialog.ModalityType, setModal(boolean)

建構子詳細資訊

Dialog

public Dialog(Frame owner)

建構一個最初不可見的、無網要的 Dialog，它帶有指定所有者 Frame 和一個空標題。

參數：

owner - dialog 的所有者，如果此 dialog 沒有所有者，則該參數為 null

拋出：

IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是來自某一螢幕設備

HeadlessException - 當 GraphicsEnvironment.isHeadless() 返回 true 時

另請參見：

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

Dialog

public Dialog(Frame owner,
              boolean modal)

建構一個最初不可見的 Dialog，它帶有指定所有者 Frame、網要和一個空標題。

參數：

owner - dialog 的所有者，如果此 dialog 沒有所有者，則該參數為 null

modal - 指定在顯示的時候是否阻止使用者將內容輸入到其他頂級視窗中。如果該參數為 false，則 dialog 是 MODELESS；如果該參數為 true，則網要型別屬性被設置為 DEFAULT_MODALITY_TYPE

拋出：

IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是來自某一螢幕設備

HeadlessException - 當 GraphicsEnvironment.isHeadless() 返回 true 時

另請參見：

Dialog.ModalityType, Dialog.ModalityType.MODELESS, DEFAULT_MODALITY_TYPE, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Frame owner,
              String title)

建構一個最初不可見的、無網要的 Dialog，它帶有指定的所有者 Frame 和標題。

參數：

owner - dialog 的所有者，如果此 dialog 沒有所有者，則該參數為 null

title - dialog 的標題，如果此 dialog 沒有標題，則該參數為 null

拋出：

IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是來自某一螢幕設備

HeadlessException - 當 GraphicsEnvironment.isHeadless() 返回 true 時

另請參見：

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

Dialog

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

建構一個最初不可見的 Dialog，它帶有指定的所有者 Frame、標題和網要。

參數：

owner - dialog 的所有者，如果此 dialog 沒有所有者，則該參數為 null

title - dialog 的標題，如果此 dialog 沒有標題，則該參數為 null

modal - 指定在顯示的時候是否阻止使用者將內容輸入到其他頂級視窗中。如果該參數為 false，則 dialog 是 MODELESS；如果該參數為 true，則網要型別屬性被設置為 DEFAULT_MODALITY_TYPE

拋出：

IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是來自某一螢幕設備

HeadlessException - 當 GraphicsEnvironment.isHeadless() 返回 true 時

另請參見：

Dialog.ModalityType, Dialog.ModalityType.MODELESS, DEFAULT_MODALITY_TYPE, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Dialog

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

建構一個最初不可見的 Dialog，它帶有指定的所有者 Frame、標題、網要和 GraphicsConfiguration。

參數：

owner - dialog 的所有者，如果此 dialog 沒有所有者，則該參數為 null

title - dialog 的標題，如果此 dialog 沒有標題，則該參數為 null

modal - 指定在顯示的時候是否阻止使用者將內容輸入到其他頂級視窗中。如果該參數為 false，則 dialog 是 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 - dialog 的所有者，如果此 dialog 沒有所有者，則該參數為 null

拋出：

IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是來自某一螢幕設備

HeadlessException - 當 GraphicsEnvironment.isHeadless() 返回 true 時

從以下版本開始：

1.2

另請參見：

GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Dialog owner,
              String title)

建構一個最初不可見的、無網要的 Dialog，它帶有指定的所有者 Dialog 和標題。

參數：

owner - dialog 的所有者，如果此 dialog 沒有所有者，則該參數為 null

title - dialog 的標題，如果此 dialog 沒有標題，則該參數為 null

拋出：

IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是來自某一螢幕設備

HeadlessException - 當 GraphicsEnvironment.isHeadless() 返回 true 時

從以下版本開始：

1.2

另請參見：

GraphicsEnvironment.isHeadless()

Dialog

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

建構一個最初不可見的 Dialog，它帶有指定的所有者 Dialog、標題和網要。

參數：

owner - dialog 的所有者，如果此 dialog 沒有所有者，則該參數為 null

title - dialog 的標題，如果此 dialog 沒有標題，則該參數為 null

modal - 指定在顯示的時候是否阻止使用者將內容輸入到其他頂級視窗中。如果該參數為 false，則 dialog 是 MODELESS；如果該參數為 true，則網要型別屬性被設置為 DEFAULT_MODALITY_TYPE

拋出：

IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是來自某一螢幕設備

HeadlessException - 當 GraphicsEnvironment.isHeadless() 返回 true 時

從以下版本開始：

1.2

另請參見：

Dialog.ModalityType, Dialog.ModalityType.MODELESS, DEFAULT_MODALITY_TYPE, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless()

Dialog

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

建構一個最初不可見的 Dialog，它帶有指定的所有者 Dialog、標題、網要和 GraphicsConfiguration。

參數：

owner - dialog 的所有者，如果此 dialog 沒有所有者，則該參數為 null

title - dialog 的標題，如果此 dialog 沒有標題，則該參數為 null

modal - 指定在顯示的時候是否阻止使用者將內容輸入到其他頂級視窗中。如果該參數為 false，則 dialog 是 MODELESS；如果該參數為 true，則網要型別屬性被設置為 DEFAULT_MODALITY_TYPE

gc - 目標螢幕設備的 GraphicsConfiguration；如果該參數為 null，則假定預設系統為 GraphicsConfiguration

拋出：

IllegalArgumentException - 如果 gc 不是來自某一螢幕設備

HeadlessException - 當 GraphicsEnvironment.isHeadless() 返回 true 時

從以下版本開始：

1.4

另請參見：

Dialog.ModalityType, Dialog.ModalityType.MODELESS, DEFAULT_MODALITY_TYPE, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Dialog

public Dialog(Window owner)

建構一個最初不可見的、無網要的 Dialog，它帶有指定所有者 Window 和一個空標題。

參數：

owner - dialog 的所有者。該所有者必須是 Dialog、Frame 以及它們的任何後代的實例，或者是 null

拋出：

IllegalArgumentException - 如果 owner 不是 Dialog 或 Frame 實例

IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是來自螢幕設備

HeadlessException - 當 GraphicsEnvironment.isHeadless() 返回 true 時

從以下版本開始：

1.6

另請參見：

GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Window owner,
              String title)

建構一個最初不可見的、無網要的 Dialog，它帶有指定的所有者 Window 和標題。

參數：

owner - dialog 的所有者。該所有者必須是 Dialog、Frame 以及它們的任何後代的實例，或者是 null

title - dialog 的標題，如果此 dialog 沒有標題，則該參數為 null

拋出：

IllegalArgumentException - 如果 owner 不是 Dialog 或 Frame 實例

IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是來自螢幕設備

HeadlessException - 當 GraphicsEnvironment.isHeadless() 返回 true 時

從以下版本開始：

1.6

另請參見：

GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Window owner,
              Dialog.ModalityType modalityType)

建構一個最初不可見的 Dialog，它帶有指定所有者 Window、網要和一個空標題。

參數：

owner - dialog 的所有者。該所有者必須是 Dialog、Frame 以及它們的任何後代的實例，或者是 null

modalityType - 指定 dialog 是否阻止使用者在顯示的時候將內容輸入其他視窗。null 值和不受支持的網要型別等效於 MODELESS

拋出：

IllegalArgumentException - 如果 owner 不是 Dialog 或 Frame 實例

IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是來自某個螢幕設備

HeadlessException - 當 GraphicsEnvironment.isHeadless() 返回 true 時

SecurityException - 如果調用執行緒沒有使用給定 modalityType 創建有網要 dialog 的權限

從以下版本開始：

1.6

另請參見：

Dialog.ModalityType, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)

Dialog

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

建構一個最初不可見的 Dialog，它帶有指定的所有者 Window、標題和網要。

參數：

owner - dialog 的所有者。該所有者必須是 Dialog、Frame 以及它們的任何後代的實例，或者是 null

title - dialog 的標題，如果此 dialog 沒有標題，則該參數為 null

modalityType - 指定 dialog 是否阻止使用者在顯示的時候將內容輸入其他視窗中。null 值和不受支持的網要型別等效於 MODELESS

拋出：

IllegalArgumentException - 如果 owner 不是 Dialog 或 Frame 實例

IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是來自某個螢幕設備

HeadlessException - 當 GraphicsEnvironment.isHeadless() 返回 true 時

SecurityException - 如果調用執行緒沒有使用給定 modalityType 創建有網要 dialog 的權限

從以下版本開始：

1.6

另請參見：

Dialog.ModalityType, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)

Dialog

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

建構一個最初不可見的 Dialog，它帶有指定的所有者 Window、標題、網要和 GraphicsConfiguration。

參數：

owner - dialog 的所有者。該所有者必須是 Dialog、Frame 以及它們的任何後代的實例，或者是 null

title - dialog 的標題，如果此 dialog 沒有標題，則該參數為 null

modalityType - 指定 dialog 是否阻止使用者在顯示的時候將內容輸入其他視窗。null 值和不受支持的網要型別等效於 MODELESS

gc - 目標螢幕設備的 GraphicsConfiguration；如果該參數為 null，則假定預設系統為 GraphicsConfiguration

拋出：

IllegalArgumentException - 如果 owner 不是 Dialog 或 Frame 實例

IllegalArgumentException - 如果 gc 不是來自某一螢幕設備

HeadlessException - 當 GraphicsEnvironment.isHeadless() 返回 true 時

SecurityException - 如果調用執行緒沒有使用給定 modalityType 創建有網要 dialog 的權限

從以下版本開始：

1.6

另請參見：

Dialog.ModalityType, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)

方法詳細資訊

addNotify

public void addNotify()

通過將此 Dialog 連接到本機螢幕資源，從而使其成為可顯示的。如果 dialog 是可顯示的，則其所有子級也將成為可顯示的。由工具套件在內部調用此方法，而不應該直接由程序調用。

覆寫：

類別 Window 中的 addNotify

另請參見：

Component.isDisplayable(), Window.removeNotify()

isModal

public boolean isModal()

指出 dialog 是否為有網要的。

此方法已過時，保留它只是為了後向相容。可以使用 getModalityType() 代替。

返回：

如果此 dialog 視窗是有網要的，則返回 true；否則返回 false

另請參見：

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

setModal

public void setModal(boolean modal)

指定此 dialog 是否應該是有網要的。

此方法已過時，保留它只是為了後向相容。可以使用 setModalityType() 代替。

註：更改可見 dialog 的網要只在隱藏該 dialog 並再次顯示它時產生效果。

參數：

modal - 指定 dialog 是否阻止在顯示的時候將內容輸入其他視窗；調用 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()

返回此 dialog 的網要型別。

返回：

此 dialog 的網要型別

從以下版本開始：

1.6

另請參見：

setModalityType(java.awt.Dialog.ModalityType)

setModalityType

public void setModalityType(Dialog.ModalityType type)

設置此 dialog 的網要型別。有關可能的網要型別，請參閱 ModalityType。

如果給定網要型別不受支持，則使用 MODELESS。您可能想在調用此方法之後調用 getModalityType()，以確保網要型別已被設置。

註：更改可見 dialog 的網要只在隱藏該 dialog 並再次顯示它時產生效果。

參數：

type - 指定 dialog 是否阻止在顯示的時候將內容輸入其他視窗。null 值和不受支持的網要型別等效於 MODELESS

拋出：

SecurityException - 如果調用執行緒沒有使用給定 modalityType 創建有網要 dialog 的權限

從以下版本開始：

1.6

另請參見：

getModalityType(), Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)

getTitle

public String getTitle()

獲取 dialog 的標題。標題顯示在 dialog 的邊界中。

返回：

此 dialog 視窗的標題。標題可以為 null。

另請參見：

setTitle(java.lang.String)

setTitle

public void setTitle(String title)

設置 Dialog 的標題。

參數：

title - 顯示在 dialog 的邊界中的標題；null 值會導致一個空標題

另請參見：

getTitle()

setVisible

public void setVisible(boolean b)

根據參數 b 的值顯示或隱藏此 Dialog。

覆寫：

類別 Window 中的 setVisible

參數：

b - 如果該參數為 true，則使 Dialog 可見，否則隱藏 Dialog。如果 dialog 和/或其所有者尚不可顯示，則使它們都變成可顯示的。在使 dialog 可見之前，將驗證該 dialog。如果該參數為 false，則隱藏 Dialog，並且隨後導致返回 setVisible(true)（如果它目前受阻塞）。

對有網要 dialog 的註釋。

• setVisible(true)：如果 dialog 尚不可見，則在通過調用 setVisible(false) 或 dispose 隱藏 dialog 之前，此調用不會返回。
• setVisible(false)：隱藏 dialog，然後返回 setVisible(true)（如果它目前受阻塞）。
• 從事件指派執行緒調用此方法是受允許的，因為在此方法受阻塞時，工具套件會確保其他事件不受阻塞。

另請參見：

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

show

@Deprecated
public void show()

已過時。 從 JDK 版本 1.5 開始，由 setVisible(boolean) 取代。

使 Dialog 可見。如果 dialog 和/或其所有者尚不可顯示，則使它們都變成可顯示的。在使 dialog 可見之前，將驗證該 dialog。如果 dialog 已經可見，則此方法會使 dialog 顯示在前面。

如果 dialog 是有網要的並且尚不可見，則在通過調用 hide 或 dispose 方法隱藏 dialog 之前，此調用不會返回。從事件指派執行緒顯示有網要 dialog 是受允許的，因為調用此方法的執行緒受阻塞時，工具套件會確保另一個事件佇列的運行。

覆寫：

類別 Window 中的 show

另請參見：

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

hide

@Deprecated
public void hide()

已過時。 從 JDK 版本 1.5 開始，由 setVisible(boolean) 取代。

隱藏 Dialog 並隨後導致返回 show（如果它目前受阻塞）。

覆寫：

類別 Window 中的 hide

另請參見：

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

toBack

public void toBack()

如果此視窗是可視的，則將此視窗置於後方，如果它是焦點視窗或活動視窗，則會導致丟失焦點或活動狀態。

在此虛擬機器中，將此視窗放在堆疊(stack)空間順序的底部，並在其他所有視窗之後顯示此視窗。如果此視窗不可見，則不發生任何操作。有些平臺不允許其他視窗擁有的視窗出現在其所有者下方。將進行所有嘗試來移動此視窗，使其位於堆疊(stack)空間順序中盡可能靠後的位置；不過，開發人員不應假定此方法在所有情況下都可以將此視窗移到所有其他視窗之下。

由於本機視窗系統多種多樣，因此無法保證對焦點視窗和活動視窗的更改能夠實作。在此視窗接收 WINDOW_LOST_FOCUS 或 WINDOW_DEACTIVATED 事件之前，開發人員不得假定此視窗不再是焦點視窗或活動視窗。在頂層視窗為焦點視窗的平臺上，此方法可能導致此視窗不再是焦點狀態。在此情況下，此虛擬機器中緊跟其後的可作為焦點的視窗將成為焦點視窗。在堆疊(stack)空間順序通常不影響焦點視窗的平臺上，此方法可能維持焦點視窗和活動視窗不變。

如果此 dialog 是有網要的並且阻止某些視窗，則所有 dialog 都被發送回來，使它們位於正受阻塞的 dialog 下。

覆寫：

類別 Window 中的 toBack

另請參見：

Window.toBack()

isResizable

public boolean isResizable()

指出此 dialog 是否可以由使用者調整大小。預設情況下，所有 dialog 最初都是可調整的。

返回：

如果使用者可以調整 dialog 的大小，則返回 true；否則返回 false。

另請參見：

setResizable(boolean)

setResizable

public void setResizable(boolean resizable)

設置此 dialog 是否可以由使用者調整大小。

參數：

resizable - 如果使用者可以調整 dialog 的大小，則返回 true；否則返回 false。

另請參見：

isResizable()

setUndecorated

public void setUndecorated(boolean undecorated)

禁用或啟用此 dialog 的裝飾。只有在 dialog 不可顯示時才調用此方法。

參數：

undecorated - 如果沒有啟用 dialog 裝飾，則為 true；如果啟用了 dialog 裝飾，則為 false。

拋出：

IllegalComponentStateException - 如果 dialog 是可顯示的。

從以下版本開始：

1.4

另請參見：

isUndecorated(), Component.isDisplayable()

isUndecorated

public boolean isUndecorated()

指出此 dialog 是否未裝飾。在預設情況下，所有 dialog 最初都是已裝飾的。

返回：

如果 dialog 為未裝飾，則為 true；否則為 false。

從以下版本開始：

1.4

另請參見：

setUndecorated(boolean)

paramString

protected String paramString()

返回表示此 dialog 狀態的字元串。此方法僅用於除錯目的，對於這兩種實作，返回字元串的內容和格式可能有所不同。返回的字元串可能為空，但不可能為 null。

覆寫：

類別 Container 中的 paramString

返回：

此 dialog 視窗的參數字元串。

getAccessibleContext

public AccessibleContext getAccessibleContext()

獲取與此 Dialog 有關的 AccessibleContext。對於 dialog 來說，AccessibleContext 採用 AccessibleAWTDialog 的某種形式。必要時創建一個新的 AccessibleAWTDialog 實例。

指定者：

介面 Accessible 中的 getAccessibleContext

覆寫：

類別 Window 中的 getAccessibleContext

返回：

AccessibleAWTDialog，用作此 Dialog 的 AccessibleContext

從以下版本開始：

1.3