javax.swing
類別 JDialog

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Dialog
                  javax.swing.JDialog

所有已實作的介面：

ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants

public class JDialog
extends Dialog
implements WindowConstants, Accessible, RootPaneContainer

創建對話框視窗的主要類別。可以使用此類別創建自定義的對話框，或者調用 JOptionPane 中的多個類別方法來創建各種標準對話框。有關創建對話框的資訊，請參閱 The Java Tutorial 中的 How to Make Dialogs 一節。

JDialog 元件包含一個 JRootPane 作為其唯一子元件。contentPane 應該是所有 JDialog 子元件的父級。為了方便使用 add 及其變體，已經覆寫了 remove 和 setLayout，以在必要時將其轉發到 contentPane。這意味著可以編寫：

       dialog.add(child);
 

將子級添加到 contentPane。contentPane 始終是非 null 的。試圖將其設置為 null 會產生異常。預設的 contentPane 有一個 BorderLayout 管理器。有關添加、移除和設置 JDialog 的 LayoutManager 的更多資訊，請參閱 RootPaneContainer。

有關 contentPane、glassPane 和 layeredPane 元件的完整描述，請參閱 JRootPane 文檔。

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

警告：Swing 不是執行緒安全的。有關更多資訊，請參閱 Swing's Threading Policy。

警告：此類別的序列化物件與以後的 Swing 版本不相容。當前序列化支持適用於短期存儲，或適用於在運行相同 Swing 版本的應用程序之間進行 RMI（Remote Method Invocation，遠端方法調用）。從 1.4 版本開始，已在 java.beans 套件中添加了支持所有 JavaBeans^TM 長期存儲的功能。請參見 XMLEncoder。

另請參見：

JOptionPane, JRootPane, RootPaneContainer

巢狀類別摘要

protected class

JDialog.AccessibleJDialog 此類別實作對 JDialog 類別的可存取性支持。

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

Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType

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

Window.AccessibleAWTWindow

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

Container.AccessibleAWTContainer

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

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

欄位摘要

protected AccessibleContext	accessibleContext
protected JRootPane	rootPane
protected boolean	rootPaneCheckingEnabled 如果為 true，則將對 add 和 setLayout 的調用轉發到 contentPane。

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

DEFAULT_MODALITY_TYPE

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

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

從介面 javax.swing.WindowConstants 繼承的欄位

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

從介面 java.awt.image.ImageObserver 繼承的欄位

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

建構子摘要

JDialog()
創建一個沒有標題並且沒有指定 Frame 所有者的無網要對話框。

JDialog(Dialog owner)
創建一個沒有標題但將指定的 Dialog 作為其所有者的無網要對話框。

JDialog(Dialog owner, boolean modal)
創建一個具有指定所有者 Dialog 和網要的對話框。

JDialog(Dialog owner, String title)
創建一個具有指定標題和指定所有者對話框的無網要對話框。

JDialog(Dialog owner, String title, boolean modal)
創建一個具有指定標題、網要和指定所有者 Dialog 的對話框。

JDialog(Dialog owner, String title, boolean modal, GraphicsConfiguration gc)
創建一個具有指定標題、所有者 Dialog、網要和 GraphicsConfiguration 的對話框。

JDialog(Frame owner)
創建一個沒有標題但將指定的 Frame 作為其所有者的無網要對話框。

JDialog(Frame owner, boolean modal)
創建一個具有指定所有者 Frame、網要和空標題的對話框。

JDialog(Frame owner, String title)
創建一個具有指定標題和指定所有者窗體的無網要對話框。

JDialog(Frame owner, String title, boolean modal)
創建一個具有指定標題、所有者 Frame 和網要的對話框。

JDialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)
創建一個具有指定標題、所有者 Frame、網要和 GraphicsConfiguration 的對話框。

JDialog(Window owner)
創建一個具有指定所有者 Window 和空標題的無網要對話框。

JDialog(Window owner, Dialog.ModalityType modalityType)
創建一個具有指定所有者 Window、網要和空標題的對話框。

JDialog(Window owner, String title)
創建一個具有指定標題和所有者 Window 的無網要對話框。

JDialog(Window owner, String title, Dialog.ModalityType modalityType)
創建一個具有指定標題、所有者 Window 和網要的對話框。

JDialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)
創建一個具有指定標題、所有者 Window、網要和 GraphicsConfiguration 的對話框。

方法摘要

protected void	addImpl(Component comp, Object constraints, int index) 添加指定的子 Component。
protected JRootPane	createRootPane() 建構子調用此方法來創建預設的 rootPane。
protected void	dialogInit() 建構子調用此方法來正確初始化 JDialog。
AccessibleContext	getAccessibleContext() 獲取與此 JDialog 關聯的 AccessibleContext。
Container	getContentPane() 返回此對話框的 contentPane 物件。
int	getDefaultCloseOperation() 返回使用者在此對話框上啟動 "close" 時所執行的操作。
Component	getGlassPane() 返回此對話框的 glassPane 物件。
Graphics	getGraphics() 為元件創建一個圖形上下文。
JMenuBar	getJMenuBar() 返回此對話框上設置的選單欄。
JLayeredPane	getLayeredPane() 返回此對話框的 layeredPane 物件。
JRootPane	getRootPane() 返回此對話框的 rootPane 物件。
TransferHandler	getTransferHandler() 獲取 transferHandler 屬性。
static boolean	isDefaultLookAndFeelDecorated() 如果應該通過當前外觀為新創建的 JDialog 提供其 Window 裝飾，則返回 true。
protected boolean	isRootPaneCheckingEnabled() 返回是否將對 add 和 setLayout 的調用轉發到 contentPane。
protected String	paramString() 返回此 JDialog 的字元串表示形式。
protected void	processWindowEvent(WindowEvent e) 根據 defaultCloseOperation 屬性的狀態處理視窗事件。
void	remove(Component comp) 從該容器中移除指定元件。
void	repaint(long time, int x, int y, int width, int height) 在 time 毫秒內重繪此元件的指定矩形區域。
void	setContentPane(Container contentPane) 設置 contentPane 屬性。
void	setDefaultCloseOperation(int operation) 設置當使用者在此對話框上啟動 "close" 時預設執行的操作。
static void	setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated) 提供一個關於是否應該通過當前外觀為新創建的 JDialog 提供其 Window 裝飾（如邊界、關閉視窗的小部件、標題……）的提示。
void	setGlassPane(Component glassPane) 設置 glassPane 屬性。
void	setJMenuBar(JMenuBar menu) 設置此對話框的選單欄。
void	setLayeredPane(JLayeredPane layeredPane) 設置 layeredPane 屬性。
void	setLayout(LayoutManager manager) 設置 LayoutManager。
protected void	setRootPane(JRootPane root) 設置 rootPane 屬性。
protected void	setRootPaneCheckingEnabled(boolean enabled) 設置是否將對 add 和 setLayout 的調用轉發到 contentPane。
void	setTransferHandler(TransferHandler newHandler) 設置 transferHandler 屬性，該屬性是支持向此元件傳輸資料的機制。
void	update(Graphics g) 調用 paint(g)。

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

addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setModalityType, setResizable, setTitle, setUndecorated, setVisible, show, 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, 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, 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, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusBackward, transferFocusDownCycle, 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, 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, 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

欄位詳細資訊

rootPane

protected JRootPane rootPane

另請參見：

getRootPane(), setRootPane(javax.swing.JRootPane)

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

如果為 true，則將對 add 和 setLayout 的調用轉發到 contentPane。此方法初始為 false，但在建構 JDialog 時將其設置為 true。

另請參見：

isRootPaneCheckingEnabled(), setRootPaneCheckingEnabled(boolean), RootPaneContainer

accessibleContext

protected AccessibleContext accessibleContext

建構子詳細資訊

JDialog

public JDialog()

創建一個沒有標題並且沒有指定 Frame 所有者的無網要對話框。一個共享的、隱藏的窗體將被設置為該對話框的所有者。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 所返回的值。

註：此建構子不允許創建沒有所有者的 JDialog。要創建沒有所有者的 JDialog，必須使用帶有 null 參數的 JDialog(Window) 或 JDialog(Dialog) 建構子。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另請參見：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Frame owner)

創建一個沒有標題但將指定的 Frame 作為其所有者的無網要對話框。如果 owner 為 null，則一個共享的、隱藏的窗體將被設置為該對話框的所有者。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 所返回的值。

註：此建構子不允許創建沒有所有者的 JDialog。要創建沒有所有者的 JDialog，必須使用帶有 null 參數的 JDialog(Window) 或 JDialog(Dialog) 建構子。

參數：

owner - 顯示該對話框的 Frame

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另請參見：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Frame owner,
               boolean modal)

創建一個具有指定所有者 Frame、網要和空標題的對話框。如果 owner 為 null，則一個共享的、隱藏的窗體將被設置為該對話框的所有者。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 所返回的值。

註：此建構子不允許創建沒有所有者的 JDialog。要創建沒有所有者的 JDialog，必須使用帶有 null 參數的 JDialog(Window) 或 JDialog(Dialog) 建構子。

參數：

owner - 顯示該對話框的 Frame

modal - 指定對話框在顯示時是否阻塞使用者向其他頂層視窗輸入。如果為 true，則網要型別屬性被設置為 DEFAULT_MODALITY_TYPE；否則對話框是無網要

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另請參見：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Frame owner,
               String title)

創建一個具有指定標題和指定所有者窗體的無網要對話框。如果 owner 為 null，則一個共享的、隱藏的窗體將被設置為該對話框的所有者。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 所返回的值。

註：此建構子不允許創建沒有所有者的 JDialog。要創建沒有所有者的 JDialog，必須使用帶有 null 參數的 JDialog(Window) 或 JDialog(Dialog) 建構子。

參數：

owner - 顯示該對話框的 Frame

title - 該對話框的標題欄中所顯示的 String

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另請參見：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

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

創建一個具有指定標題、所有者 Frame 和網要的對話框。如果 owner 為 null，則一個共享的、隱藏的窗體將被設置為該對話框的所有者。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 所返回的值。

註：強制要求在有網要對話框中所創建的所有彈出式元件（JComboBox、JPopupMenu、JMenuBar）都是輕量級的。

註：此建構子不允許創建沒有所有者的 JDialog。要創建沒有所有者的 JDialog，必須使用帶有 null 參數的 JDialog(Window) 或 JDialog(Dialog) 建構子。

參數：

owner - 顯示該對話框的 Frame

title - 該對話框的標題欄中所顯示的 String

modal - 指定對話框在顯示時是否阻塞使用者向其他頂層視窗輸入。如果為 true，則網要型別屬性被設置為 DEFAULT_MODALITY_TYPE；否則對話框是無網要的。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另請參見：

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

JDialog

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

創建一個具有指定標題、所有者 Frame、網要和 GraphicsConfiguration 的對話框。如果 owner 為 null，則一個共享的、隱藏的窗體將被設置為該對話框的所有者。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 返回的值。

註：強制要求在有網要對話框中所創建的所有彈出式元件（JComboBox、JPopupMenu、JMenuBar）都是輕量級的。

註：此建構子不允許創建沒有所有者的 JDialog。要創建沒有所有者的 JDialog，必須使用帶有 null 參數的 JDialog(Window) 或 JDialog(Dialog) 建構子。

參數：

owner - 顯示該對話框的 Frame

title - 該對話框的標題欄中所顯示的 String

modal - 指定對話框在顯示時是否阻塞使用者向其他頂層視窗輸入。如果為 true，則網要型別屬性被設置為 DEFAULT_MODALITY_TYPE；否則對話框是無網要的。

gc - 目標螢幕設備的 GraphicsConfiguration。如果 gc 為 null，則使用與 Frame 相同的 GraphicsConfiguration。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

從以下版本開始：

1.4

另請參見：

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

JDialog

public JDialog(Dialog owner)

創建一個沒有標題但將指定的 Dialog 作為其所有者的無網要對話框。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 所返回的值。

參數：

owner - 顯示該對話框的所有者 Dialog；如果此對話框沒有所有者，則為 null

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另請參見：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Dialog owner,
               boolean modal)

創建一個具有指定所有者 Dialog 和網要的對話框。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 所返回的值。

參數：

owner - 顯示該對話框的所有者 Dialog；如果此對話框沒有所有者，則為 null

modal - 指定對話框在顯示時是否阻塞使用者向其他頂層視窗輸入。如果為 true，則網要型別屬性被設置為 DEFAULT_MODALITY_TYPE；否則對話框是無網要的。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另請參見：

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

JDialog

public JDialog(Dialog owner,
               String title)

創建一個具有指定標題和指定所有者對話框的無網要對話框。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 所返回的值。

參數：

owner - 顯示該對話框的所有者 Dialog；如果此對話框沒有所有者，則為 null

title - 該對話框的標題欄中所顯示的 String

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另請參見：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

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

創建一個具有指定標題、網要和指定所有者 Dialog 的對話框。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 所返回的值。

參數：

owner - 顯示該對話框的所有者 Dialog；如果此對話框沒有所有者，則為 null

title - 該對話框的標題欄中所顯示的 String

modal - 指定對話框在顯示時是否阻塞使用者向其他頂層視窗輸入。如果為 true，則網要型別屬性被設置為 DEFAULT_MODALITY_TYPE；否則對話框是無網要的。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另請參見：

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

JDialog

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

創建一個具有指定標題、所有者 Dialog、網要和 GraphicsConfiguration 的對話框。

註：強制要求在有網要對話框中所創建的所有彈出式元件（JComboBox、JPopupMenu、JMenuBar）都是輕量級的。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 所返回的值。

參數：

owner - 顯示該對話框的所有者 Dialog；如果此對話框沒有所有者，則為 null

title - 該對話框的標題欄中所顯示的 String

modal - 指定對話框在顯示時是否阻塞使用者向其他頂層視窗輸入。如果為 true，則網要型別屬性被設置為 DEFAULT_MODALITY_TYPE；否則對話框是無網要的。

gc - 目標螢幕設備的 GraphicsConfiguration。如果 gc 為 null，則使用與 Dialog 相同的 GraphicsConfiguration。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

從以下版本開始：

1.4

另請參見：

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

JDialog

public JDialog(Window owner)

創建一個具有指定所有者 Window 和空標題的無網要對話框。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 所返回的值。

參數：

owner - 顯示該對話框的 Window；如果此對話框沒有所有者，則為 null

拋出：

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

從以下版本開始：

1.6

另請參見：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Window owner,
               Dialog.ModalityType modalityType)

創建一個具有指定所有者 Window、網要和空標題的對話框。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 所返回的值。

參數：

owner - 顯示該對話框的 Window；如果此對話框沒有所有者，則為 null

modalityType - 指定對話框在顯示時是否阻塞向其他視窗輸入。null 值和不受支持的網要型別等效於 MODELESS

拋出：

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

從以下版本開始：

1.6

另請參見：

Dialog.ModalityType, Dialog.setModal(boolean), Dialog.setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Window owner,
               String title)

創建一個具有指定標題和所有者 Window 的無網要對話框。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 所返回的值。

參數：

owner - 顯示該對話框的 Window；如果此對話框沒有所有者，則為 null

title - 該對話框的標題欄中所顯示的 String；如果該對話框沒有標題，則為 null

拋出：

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

從以下版本開始：

1.6

另請參見：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

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

創建一個具有指定標題、所有者 Window 和網要的對話框。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 所返回的值。

參數：

owner - 顯示該對話框的 Window；如果此對話框沒有所有者，則為 null

title - 該對話框的標題欄中所顯示的 String；如果該對話框沒有標題，則為 null

modalityType - 指定對話框在顯示時是否阻塞向其他視窗輸入。null 值和不受支持的網要型別等效於 MODELESS

拋出：

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

從以下版本開始：

1.6

另請參見：

Dialog.ModalityType, Dialog.setModal(boolean), Dialog.setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

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

創建一個具有指定標題、所有者 Window、網要和 GraphicsConfiguration 的對話框。

註：強制要求在有網要對話框中所創建的所有彈出式元件（JComboBox、JPopupMenu、JMenuBar）都是輕量級的。

此建構子將該元件的語言環境屬性設置為 JComponent.getDefaultLocale 所返回的值。

參數：

owner - 顯示該對話框的 Window；如果此對話框沒有所有者，則為 null

title - 該對話框的標題欄中所顯示的 String；如果該對話框沒有標題，則為 null

modalityType - 指定對話框在顯示時是否阻塞向其他視窗輸入。null 值和不受支持的網要型別等效於 MODELESS

gc - 目標螢幕設備的 GraphicsConfiguration；如果為 null，則使用擁有視窗的 GraphicsConfiguration；如果 owner 也為 null，則假定它為系統預設的 GraphicsConfiguration

拋出：

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

從以下版本開始：

1.6

另請參見：

Dialog.ModalityType, Dialog.setModal(boolean), Dialog.setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

方法詳細資訊

dialogInit

protected void dialogInit()

建構子調用此方法來正確初始化 JDialog。

createRootPane

protected JRootPane createRootPane()

建構子調用此方法來創建預設的 rootPane。

processWindowEvent

protected void processWindowEvent(WindowEvent e)

根據 defaultCloseOperation 屬性的狀態處理視窗事件。

覆寫：

類別 Window 中的 processWindowEvent

參數：

e - 視窗事件

另請參見：

setDefaultCloseOperation(int)

setDefaultCloseOperation

public void setDefaultCloseOperation(int operation)

設置當使用者在此對話框上啟動 "close" 時預設執行的操作。必須指定以下選項之一：

• DO_NOTHING_ON_CLOSE（在 WindowConstants 中定義）：不執行任何操作；需要程序在已註冊的 WindowListener 物件的 windowClosing 方法中處理該操作。
• HIDE_ON_CLOSE（在 WindowConstants 中定義）：調用任意已註冊的 WindowListener 物件後自動隱藏該對話框。
• DISPOSE_ON_CLOSE（WindowConstants 中定義的）：調用任意已註冊的 WindowListener 物件後自動隱藏並處置該對話框。

預設將該值設置為 HIDE_ON_CLOSE。對此屬性的值的更改將導致觸發屬性更改事件，帶有屬性名稱 "defaultCloseOperation"。

註：當 Java 虛擬機器 (VM) 中最後的可顯示視窗被移除後，虛擬機器可能會終止。有關更多資訊，請參閱 AWT Threading Issues。

參數：

operation - 當使用者關閉該對話框時應該執行的操作

拋出：

IllegalArgumentException - 如果 defaultCloseOperation 值不是上述有效值之一

另請參見：

Window.addWindowListener(java.awt.event.WindowListener), getDefaultCloseOperation(), WindowConstants

getDefaultCloseOperation

public int getDefaultCloseOperation()

返回使用者在此對話框上啟動 "close" 時所執行的操作。

返回：

一個指示視窗關閉操作的整數

另請參見：

setDefaultCloseOperation(int)

setTransferHandler

public void setTransferHandler(TransferHandler newHandler)

設置 transferHandler 屬性，該屬性是支持向此元件傳輸資料的機制。如果該元件不支持資料傳輸操作，那麼請使用 null。

如果系統屬性 suppressSwingDropSupport 為 false（預設值），並且此元件上的當前放置目標為 null 或者不是使用者設置的放置目標，則此方法將按如下方式更改放置目標：如果 newHandler 為 null，則它將清除放置目標。如果不為 null，則它將安裝一個新的 DropTarget。

註：當用於 JDialog 時，TransferHandler 只提供資料導入功能，與資料導出有關的方法當前用於 JComponent。

有關更多資訊，請參閱 The Java Tutorial 中的 How to Use Drag and Drop and Data Transfer 一節。

參數：

newHandler - 新的 TransferHandler

從以下版本開始：

1.6

另請參見：

TransferHandler, getTransferHandler(), Component.setDropTarget(java.awt.dnd.DropTarget)

getTransferHandler

public TransferHandler getTransferHandler()

獲取 transferHandler 屬性。

返回：

transferHandler 屬性的值

從以下版本開始：

1.6

另請參見：

TransferHandler, setTransferHandler(javax.swing.TransferHandler)

update

public void update(Graphics g)

調用 paint(g)。覆寫此方法，以防止不必要的清除背景調用。

覆寫：

類別 Container 中的 update

參數：

g - 在其中進行繪製的 Graphics 上下文

另請參見：

Component.update(Graphics)

setJMenuBar

public void setJMenuBar(JMenuBar menu)

設置此對話框的選單欄。

參數：

menu - 該對話框中放置的選單欄

另請參見：

getJMenuBar()

getJMenuBar

public JMenuBar getJMenuBar()

返回此對話框上設置的選單欄。

另請參見：

setJMenuBar(javax.swing.JMenuBar)

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

返回是否將對 add 和 setLayout 的調用轉發到 contentPane。

返回：

如果轉發 add 和 setLayout，則返回 true；否則返回 false

另請參見：

addImpl(java.awt.Component, java.lang.Object, int), setLayout(java.awt.LayoutManager), setRootPaneCheckingEnabled(boolean), RootPaneContainer

setRootPaneCheckingEnabled

protected void setRootPaneCheckingEnabled(boolean enabled)

設置是否將對 add 和 setLayout 的調用轉發到 contentPane。

參數：

enabled - 如果轉發 add 和 setLayout，則為 true；如果應該直接在 JDialog 上操作，則為 false。

另請參見：

addImpl(java.awt.Component, java.lang.Object, int), setLayout(java.awt.LayoutManager), isRootPaneCheckingEnabled(), RootPaneContainer

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)

添加指定的子 Component。覆寫此方法，以有條件地將調用轉發到 contentPane。預設情況下將子元件添加到 contentPane，而不是窗體中，有關此內容的詳情，請參閱 RootPaneContainer。

覆寫：

類別 Container 中的 addImpl

參數：

comp - 要增強的元件

constraints - 要遵守的約束條件

index - 索引

拋出：

IllegalArgumentException - 如果 index 無效

IllegalArgumentException - 如果將容器的父級添加到其本身

IllegalArgumentException - 如果向容器內添加視窗

另請參見：

setRootPaneCheckingEnabled(boolean), RootPaneContainer

remove

public void remove(Component comp)

從該容器中移除指定元件。如果 comp 不是 rootPane，則將該調用轉發到 contentPane。如果 comp 不是 JDialog 或 contentPane 的子級，則不執行任何操作。

覆寫：

類別 Container 中的 remove

參數：

comp - 要移除的元件

拋出：

NullPointerException - 如果 comp 為 null

另請參見：

Container.add(java.awt.Component), RootPaneContainer

setLayout

public void setLayout(LayoutManager manager)

設置 LayoutManager。覆寫此方法，以有條件地將調用轉發到 contentPane。有關此內容的更多資訊，請參閱 RootPaneContainer。

覆寫：

類別 Container 中的 setLayout

參數：

manager - the LayoutManager

另請參見：

setRootPaneCheckingEnabled(boolean), RootPaneContainer

getRootPane

public JRootPane getRootPane()

返回此對話框的 rootPane 物件。

指定者：

介面 RootPaneContainer 中的 getRootPane

返回：

此元件的單個 JRootPane 子元件。

另請參見：

setRootPane(javax.swing.JRootPane), RootPaneContainer.getRootPane()

setRootPane

protected void setRootPane(JRootPane root)

設置 rootPane 屬性。此方法由建構子調用。

參數：

root - 此對話框的 rootPane 物件

另請參見：

getRootPane()

getContentPane

public Container getContentPane()

返回此對話框的 contentPane 物件。

指定者：

介面 RootPaneContainer 中的 getContentPane

返回：

contentPane 屬性

另請參見：

setContentPane(java.awt.Container), RootPaneContainer.getContentPane()

setContentPane

public void setContentPane(Container contentPane)

設置 contentPane 屬性。此方法由建構子調用。

Swing 的繪製架構要求在包含層次結構中有不透明的 JComponent。這通常由內容窗格提供。如果要替換內容窗格，建議用不透明的 JComponent 替換它。

指定者：

介面 RootPaneContainer 中的 setContentPane

參數：

contentPane - 此對話框的 contentPane 物件

拋出：

IllegalComponentStateException - （運行時異常）如果 contentPane 參數為 null

另請參見：

JRootPane, getContentPane(), RootPaneContainer.setContentPane(java.awt.Container)

getLayeredPane

public JLayeredPane getLayeredPane()

返回此對話框的 layeredPane 物件。

指定者：

介面 RootPaneContainer 中的 getLayeredPane

返回：

layeredPane 屬性

另請參見：

setLayeredPane(javax.swing.JLayeredPane), RootPaneContainer.getLayeredPane()

setLayeredPane

public void setLayeredPane(JLayeredPane layeredPane)

設置 layeredPane 屬性。此方法由建構子調用。

指定者：

介面 RootPaneContainer 中的 setLayeredPane

參數：

layeredPane - 新的 layeredPane 屬性

拋出：

IllegalComponentStateException - （運行時異常）如果 layeredPane 參數為 null

另請參見：

getLayeredPane(), RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)

getGlassPane

public Component getGlassPane()

返回此對話框的 glassPane 物件。

指定者：

介面 RootPaneContainer 中的 getGlassPane

返回：

glassPane 屬性

另請參見：

setGlassPane(java.awt.Component), RootPaneContainer.getGlassPane()

setGlassPane

public void setGlassPane(Component glassPane)

設置 glassPane 屬性。此方法由建構子調用。

指定者：

介面 RootPaneContainer 中的 setGlassPane

參數：

glassPane - 此對話框的 glassPane 物件

另請參見：

getGlassPane(), RootPaneContainer.setGlassPane(java.awt.Component)

getGraphics

public Graphics getGraphics()

為元件創建一個圖形上下文。如果元件當前是不可顯示的，則此方法返回 null。

覆寫：

類別 Component 中的 getGraphics

返回：

元件的圖形上下文，如果其沒有，則返回 null

從以下版本開始：

1.6

另請參見：

Component.paint(java.awt.Graphics)

repaint

public void repaint(long time,
                    int x,
                    int y,
                    int width,
                    int height)

在 time 毫秒內重繪此元件的指定矩形區域。有關如何處理重繪的詳細資訊，請參閱 RepaintManager。

覆寫：

類別 Component 中的 repaint

參數：

time - 更新前等待的最長時間（以毫秒為單位）

x - x 坐標

y - y 坐標

width - 寬度

height - 高度

從以下版本開始：

1.6

另請參見：

RepaintManager

setDefaultLookAndFeelDecorated

public static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)

提供一個關於是否應該通過當前外觀為新創建的 JDialog 提供其 Window 裝飾（如邊界、關閉視窗的小部件、標題……）的提示。如果 defaultLookAndFeelDecorated 為 true、當前 LookAndFeel 支持提供 Window 裝飾，並且當前視窗管理器支持未裝飾的視窗，則通過當前 LookAndFeel 為新創建的 JDialog 提供其 Window 裝飾。否則，通過當前視窗管理器為新創建的 JDialog 提供其 Window 裝飾。

執行下列操作可在單個 JDialog 上獲取相同的效果：

    JDialog dialog = new JDialog();
    dialog.setUndecorated(true);
    dialog.getRootPane().setWindowDecorationStyle(JRootPane.PLAIN_DIALOG);
 

參數：

defaultLookAndFeelDecorated - 關於當前外觀是否應該提供 window 裝飾的提示

從以下版本開始：

1.4

另請參見：

LookAndFeel.getSupportsWindowDecorations()

isDefaultLookAndFeelDecorated

public static boolean isDefaultLookAndFeelDecorated()

如果應該通過當前外觀為新創建的 JDialog 提供其 Window 裝飾，則返回 true。這只是一個提示，因為某些外觀可能不支持此功能。

返回：

如果外觀應該提供 Window 裝飾，則返回 true。

從以下版本開始：

1.4

paramString

protected String paramString()

返回此 JDialog 的字元串表示形式。此方法僅在進行除錯時使用，對於各個實作，所返回字元串的內容和格式可能有所不同。返回的字元串可以為空，但不可以為 null。

覆寫：

類別 Dialog 中的 paramString

返回：

此 JDialog 的字元串表示形式。

getAccessibleContext

public AccessibleContext getAccessibleContext()

獲取與此 JDialog 關聯的 AccessibleContext。對於 JDialog 來說，AccessibleContext 採用 AccessibleJDialog 的形式。如有必要，可創建一個新的 AccessibleJDialog 實例。

指定者：

介面 Accessible 中的 getAccessibleContext

覆寫：

類別 Dialog 中的 getAccessibleContext

返回：

一個 AccessibleJDialog，它充當此 JDialog 的 AccessibleContext