- すべての実装されたインタフェース:
ImageObserver
,MenuContainer
,Serializable
,Accessible
,RootPaneContainer
,WindowConstants
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に適しています。 1.4では、すべてのJavaBeansの長期ストレージのサポートがjava.beans
パッケージに追加されました。 XMLEncoder
を参照してください。
- 導入されたバージョン:
- 1.2
- 関連項目:
-
ネストされたクラスのサマリー
クラス java.awt.Dialogで宣言されたネストされたクラス/インタフェース
Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType
クラス java.awt.Windowで宣言されたネストされたクラス/インタフェース
Window.AccessibleAWTWindow, Window.Type
クラス java.awt.Containerで宣言されたネストされたクラス/インタフェース
Container.AccessibleAWTContainer
クラス java.awt.Componentで宣言されたネストされたクラス/インタフェース
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
フィールドのサマリー
修飾子と型フィールド説明protected AccessibleContext
このJDialog
に関連付けられたAccessibleContext
protected JRootPane
protected boolean
trueの場合は、add
およびsetLayout
の呼出しがcontentPane
に転送されます。クラス java.awt.Dialogで宣言されたフィールド
DEFAULT_MODALITY_TYPE
クラス 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
インタフェース javax.swing.WindowConstantsで宣言されたフィールド
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE
-
コンストラクタのサマリー
コンストラクタ説明JDialog()
タイトルがなく、所有者Frame
の指定もないモードなしダイアログを作成します。指定されたDialog
(所有者として)と空のタイトルで、モードなしダイアログを作成します。空のタイトル、指定されたモーダリティ、およびDialog
(所有者として)で、ダイアログを作成します。指定されたタイトルと指定された所有者ダイアログで、モードなしダイアログを作成します。タイトル、モーダリティ、所有者Dialog
で、ダイアログを作成します。JDialog
(Dialog owner, String title, boolean modal, GraphicsConfiguration gc) 指定されたタイトル、所有者Dialog
、モーダリティ、およびGraphicsConfiguration
で、ダイアログを作成します。指定されたFrame
(所有者として)と空のタイトルで、モードなしダイアログを作成します。空のタイトル、指定されたモーダリティ、およびFrame
(所有者として)で、ダイアログを作成します。指定されたタイトルと指定された所有者フレームで、モードなしダイアログを作成します。指定されたタイトル、所有者Frame
、およびモーダリティで、ダイアログを作成します。JDialog
(Frame owner, String title, boolean modal, GraphicsConfiguration gc) 指定されたタイトル、所有者Frame
、モーダリティ、およびGraphicsConfiguration
で、ダイアログを作成します。指定されたWindow
(所有者として)と空のタイトルを含むモードなしダイアログを作成します。JDialog
(Window owner, Dialog.ModalityType modalityType) 空のタイトル、指定されたモーダリティ、およびWindow
(所有者として)を含むダイアログを作成します。タイトルと所有者Window
を指定してモードなしダイアログを作成します。JDialog
(Window owner, String title, Dialog.ModalityType modalityType) 指定されたタイトル、所有者Window
、およびモーダリティで、ダイアログを作成します。JDialog
(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc) 指定されたタイトル、所有者Window
、モーダリティ、およびGraphicsConfiguration
で、ダイアログを作成します。 -
メソッドのサマリー
修飾子と型メソッド説明protected void
指定された子Component
を追加します。protected JRootPane
デフォルトのrootPane
を作成するために、コンストラクタ・メソッドから呼び出されます。protected void
JDialog
を適切に初期化するためにコンストラクタによって呼び出されます。このJDialogに関連付けられたAccessibleContextを取得します。このダイアログのcontentPane
オブジェクトを返します。int
ユーザーがこのダイアログで「クローズ」を開始したときに実行される処理を返します。このダイアログのglassPane
オブジェクトを返します。このコンポーネントのグラフィックス・コンテキストを作成します。このダイアログに設定されているメニュー・バーを返します。このダイアログのlayeredPane
オブジェクトを返します。このダイアログのrootPane
オブジェクトを返します。transferHandler
プロパティを取得します。static boolean
新しく生成されるJDialog
の現在のルック・アンド・フィールで実行できるウィンドウ装飾を保持する場合はtrueを返します。protected boolean
add
およびsetLayout
の呼出しがcontentPane
に転送されるかどうかを返します。protected String
このJDialog
の文字列表現を返します。protected void
defaultCloseOperation
プロパティの状態に応じて、ウィンドウ・イベントを処理します。void
指定されたコンポーネントをコンテナから削除します。void
repaint
(long time, int x, int y, int width, int height) このコンポーネントの指定された矩形をtime
ミリ秒以内に再ペイントします。void
setContentPane
(Container contentPane) contentPane
プロパティを設定します。void
setDefaultCloseOperation
(int operation) ユーザーがこのダイアログの「クローズ」を開始したときに、デフォルトで実行される処理を設定します。static void
setDefaultLookAndFeelDecorated
(boolean defaultLookAndFeelDecorated) 新しく生成されるJDialog
が、現在のルック・アンド・フィールで実行できるボーダー、ウィンドウ・クローズ用ウィジェット、タイトルなどのウィンドウ装飾を保持するかどうかのヒントが用意されています。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
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, 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, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBackground, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setOpacity, setShape, setSize, setSize, setType, toFront
クラス java.awt.Containerで宣言されたメソッド
add, add, add, add, add, addContainerListener, 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, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, 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, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
フィールド詳細
-
rootPane
protected JRootPane rootPane -
rootPaneCheckingEnabled
protected boolean rootPaneCheckingEnabledtrueの場合は、add
およびsetLayout
の呼出しがcontentPane
に転送されます。 最初はfalseですが、JDialog
が構築されると、trueに設定されます。 -
accessibleContext
protected AccessibleContext accessibleContextこのJDialog
に関連付けられたAccessibleContext
-
-
コンストラクタの詳細
-
JDialog
public JDialog()タイトルがなく、所有者Frame
の指定もないモードなしダイアログを作成します。 共有されて、隠れたフレームがダイアログの所有者として設定されます。このコンストラクタはコンポーネントのローカル・プロパティを
JComponent.getDefaultLocale
によって返された値に設定します。ノート: このコンストラクタでは、所有者なしの
JDialog
を作成することはできません。 所有者なしのJDialog
を作成するには、引数null
を指定して、JDialog(Window)
コンストラクタまたはJDialog(Dialog)
コンストラクタを使用する必要があります。- 例外:
HeadlessException
-GraphicsEnvironment.isHeadless()
がtrue
を返す場合。- 関連項目:
-
JDialog
public JDialog(Frame owner) 指定されたFrame
(所有者として)と空のタイトルで、モードなしダイアログを作成します。owner
がnull
の場合、共有の非表示フレームがダイアログの所有者として設定されます。このコンストラクタはコンポーネントのローカル・プロパティを
JComponent.getDefaultLocale
によって返された値に設定します。ノート: このコンストラクタでは、所有者なしの
JDialog
を作成することはできません。 所有者なしのJDialog
を作成するには、引数null
を指定して、JDialog(Window)
コンストラクタまたはJDialog(Dialog)
コンストラクタを使用する必要があります。- パラメータ:
owner
- ダイアログを表示するFrame
- 例外:
HeadlessException
-GraphicsEnvironment.isHeadless()
がtrue
を返す場合。- 関連項目:
-
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
を返す場合。- 関連項目:
-
JDialog
指定されたタイトルと指定された所有者フレームで、モードなしダイアログを作成します。owner
がnull
の場合、共有の非表示フレームがダイアログの所有者として設定されます。このコンストラクタはコンポーネントのローカル・プロパティを
JComponent.getDefaultLocale
によって返された値に設定します。ノート: このコンストラクタでは、所有者なしの
JDialog
を作成することはできません。 所有者なしのJDialog
を作成するには、引数null
を指定して、JDialog(Window)
コンストラクタまたはJDialog(Dialog)
コンストラクタを使用する必要があります。- パラメータ:
owner
- ダイアログを表示するFrame
title
- ダイアログのタイトル・バーに表示されるString
- 例外:
HeadlessException
-GraphicsEnvironment.isHeadless()
がtrue
を返す場合。- 関連項目:
-
JDialog
指定されたタイトル、所有者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
を返す場合。- 関連項目:
-
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
。null
の場合は、デフォルトのシステムGraphicsConfiguration
と見なされる- 例外:
HeadlessException
-GraphicsEnvironment.isHeadless()
がtrue
を返す場合。- 導入されたバージョン:
- 1.4
- 関連項目:
-
JDialog
public JDialog(Dialog owner) 指定されたDialog
(所有者として)と空のタイトルで、モードなしダイアログを作成します。このコンストラクタはコンポーネントのローカル・プロパティを
JComponent.getDefaultLocale
によって返された値に設定します。- パラメータ:
owner
- ダイアログを表示する所有者Dialog
。このダイアログに所有者がいない場合はnull
- 例外:
HeadlessException
-if GraphicsEnvironment.isHeadless()
はtrue
を返します。- 関連項目:
-
JDialog
public JDialog(Dialog owner, boolean modal) 空のタイトル、指定されたモーダリティ、およびDialog
(所有者として)で、ダイアログを作成します。このコンストラクタはコンポーネントのローカル・プロパティを
JComponent.getDefaultLocale
によって返された値に設定します。- パラメータ:
owner
- ダイアログを表示する所有者Dialog
。このダイアログに所有者がいない場合はnull
modal
- ダイアログが表示されているとき、他のトップレベルのウィンドウへのユーザー入力をブロックするかどうかを指定する。true
の場合、モーダリティ・タイプ・プロパティはDEFAULT_MODALITY_TYPE
に設定される。そうでない場合は、モードなしダイアログになる。- 例外:
HeadlessException
-GraphicsEnvironment.isHeadless()
がtrue
を返す場合。- 関連項目:
-
JDialog
指定されたタイトルと指定された所有者ダイアログで、モードなしダイアログを作成します。このコンストラクタはコンポーネントのローカル・プロパティを
JComponent.getDefaultLocale
によって返された値に設定します。- パラメータ:
owner
- ダイアログを表示する所有者Dialog
。このダイアログに所有者がいない場合はnull
title
- ダイアログのタイトル・バーに表示されるString
- 例外:
HeadlessException
-GraphicsEnvironment.isHeadless()
がtrue
を返す場合。- 関連項目:
-
JDialog
タイトル、モーダリティ、所有者Dialog
で、ダイアログを作成します。このコンストラクタはコンポーネントのローカル・プロパティを
JComponent.getDefaultLocale
によって返された値に設定します。- パラメータ:
owner
- ダイアログを表示する所有者Dialog
。このダイアログに所有者がいない場合はnull
title
- ダイアログのタイトル・バーに表示されるString
modal
- ダイアログが表示されているとき、他のトップレベルのウィンドウへのユーザー入力をブロックするかどうかを指定する。true
の場合、モーダリティ・タイプ・プロパティはDEFAULT_MODALITY_TYPE
に設定される。そうでない場合は、モードなしダイアログになる- 例外:
HeadlessException
-GraphicsEnvironment.isHeadless()
がtrue
を返す場合。- 関連項目:
-
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
。null
の場合は、デフォルトのシステムGraphicsConfiguration
と見なされる- 例外:
HeadlessException
-GraphicsEnvironment.isHeadless()
がtrue
を返す場合。- 導入されたバージョン:
- 1.4
- 関連項目:
-
JDialog
public JDialog(Window owner) 指定されたWindow
(所有者として)と空のタイトルを含むモードなしダイアログを作成します。このコンストラクタはコンポーネントのローカル・プロパティを
JComponent.getDefaultLocale
によって返された値に設定します。- パラメータ:
owner
- ダイアログを表示するWindow
。このダイアログに所有者がいない場合はnull
- 例外:
IllegalArgumentException
-owner
がDialog
またはFrame
のインスタンスでない場合IllegalArgumentException
-owner
のGraphicsConfiguration
が画面デバイスのものでない場合HeadlessException
-GraphicsEnvironment.isHeadless()
がtrue
を返した場合- 導入されたバージョン:
- 1.6
- 関連項目:
-
JDialog
public JDialog(Window owner, Dialog.ModalityType modalityType) 空のタイトル、指定されたモーダリティ、およびWindow
(所有者として)を含むダイアログを作成します。このコンストラクタはコンポーネントのローカル・プロパティを
JComponent.getDefaultLocale
によって返された値に設定します。- パラメータ:
owner
- ダイアログを表示するWindow
。このダイアログに所有者がいない場合はnull
modalityType
- ダイアログが表示されているときに、ほかのウィンドウへの入力がブロックされるかどうかを指定する。null
値とサポートされないモーダリティ・タイプはMODELESS
と同等である- 例外:
IllegalArgumentException
-owner
がDialog
またはFrame
のインスタンスでない場合IllegalArgumentException
-owner
のGraphicsConfiguration
が画面デバイスのものでない場合HeadlessException
-GraphicsEnvironment.isHeadless()
がtrue
を返した場合SecurityException
- 呼出し元スレッドに、modalityType
が指定されたモーダル・ダイアログを作成するためのアクセス権がない場合- 導入されたバージョン:
- 1.6
- 関連項目:
-
JDialog
タイトルと所有者Window
を指定してモードなしダイアログを作成します。このコンストラクタはコンポーネントのローカル・プロパティを
JComponent.getDefaultLocale
によって返された値に設定します。- パラメータ:
owner
- ダイアログを表示するWindow
。このダイアログに所有者がいない場合はnull
title
- ダイアログのタイトル・バーに表示されるString
。ダイアログにタイトルがない場合はnull
- 例外:
IllegalArgumentException
-owner
がDialog
またはFrame
のインスタンスでない場合IllegalArgumentException
-owner
のGraphicsConfiguration
が画面デバイスのものでない場合HeadlessException
-GraphicsEnvironment.isHeadless()
がtrue
を返した場合- 導入されたバージョン:
- 1.6
- 関連項目:
-
JDialog
public JDialog(Window owner, String title, Dialog.ModalityType modalityType) 指定されたタイトル、所有者Window
、およびモーダリティで、ダイアログを作成します。このコンストラクタはコンポーネントのローカル・プロパティを
JComponent.getDefaultLocale
によって返された値に設定します。- パラメータ:
owner
- ダイアログを表示するWindow
。このダイアログに所有者がいない場合はnull
title
- ダイアログのタイトル・バーに表示されるString
。ダイアログにタイトルがない場合はnull
modalityType
- ダイアログが表示されているときに、ほかのウィンドウへの入力がブロックされるかどうかを指定する。null
値とサポートされないモーダリティ・タイプはMODELESS
と同等である- 例外:
IllegalArgumentException
-owner
がDialog
またはFrame
のインスタンスでない場合IllegalArgumentException
-owner
のGraphicsConfiguration
が画面デバイスのものでない場合HeadlessException
-GraphicsEnvironment.isHeadless()
がtrue
を返した場合SecurityException
- 呼出し元スレッドに、modalityType
が指定されたモーダル・ダイアログを作成するためのアクセス権がない場合- 導入されたバージョン:
- 1.6
- 関連項目:
-
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
と見なされる- 例外:
IllegalArgumentException
-owner
がDialog
またはFrame
のインスタンスでない場合IllegalArgumentException
-owner
のGraphicsConfiguration
が画面デバイスのものでない場合HeadlessException
-GraphicsEnvironment.isHeadless()
がtrue
を返した場合SecurityException
- 呼出し元スレッドに、modalityType
が指定されたモーダル・ダイアログを作成するためのアクセス権がない場合- 導入されたバージョン:
- 1.6
- 関連項目:
-
-
メソッドの詳細
-
dialogInit
protected void dialogInit()JDialog
を適切に初期化するためにコンストラクタによって呼び出されます。 -
createRootPane
protected JRootPane createRootPane()デフォルトのrootPane
を作成するために、コンストラクタ・メソッドから呼び出されます。- 戻り値:
- 新しい
JRootPane
。
-
processWindowEvent
protected void processWindowEvent(WindowEvent e) defaultCloseOperation
プロパティの状態に応じて、ウィンドウ・イベントを処理します。- オーバーライド:
processWindowEvent
、クラスWindow
- パラメータ:
e
- ウィンドウ・イベント- 関連項目:
-
setDefaultCloseOperation
@BeanProperty(preferred=true, enumerationValues={"WindowConstants.DO_NOTHING_ON_CLOSE","WindowConstants.HIDE_ON_CLOSE","WindowConstants.DISPOSE_ON_CLOSE"}, description="The dialog\'s default close operation.") public void setDefaultCloseOperation(int operation) ユーザーがこのダイアログの「クローズ」を開始したときに、デフォルトで実行される処理を設定します。 次のうち1つを指定する必要があります。
DO_NOTHING_ON_CLOSE
(WindowConstants
に定義): 何も行わない。プログラムは登録されているWindowListener
オブジェクトのwindowClosing
メソッドで処理を行う必要がある。HIDE_ON_CLOSE
(WindowConstants
に定義): 登録されている任意のWindowListener
オブジェクトを呼び出したあとで、自動的にダイアログを隠す。DISPOSE_ON_CLOSE
(WindowConstants
に定義): 登録されている任意のWindowListener
オブジェクトを呼び出したあとで、自動的にダイアログを隠して破棄する。
デフォルトでは
HIDE_ON_CLOSE
が設定されます。 このプロパティの値を変更すると、プロパティ名defaultCloseOperationでプロパティ変更イベントがトリガーされます。ノート: Java仮想マシン(VM)内で最後の表示可能なウィンドウが破棄されると、VMが終了することがあります。 詳細は、「AWTスレッドの問題」を参照してください。
- パラメータ:
operation
- ユーザーがダイアログを閉じるときに実行されるべき処理- 例外:
IllegalArgumentException
- defaultCloseOperationの値が前述の有効な値と異なる場合- 関連項目:
-
getDefaultCloseOperation
public int getDefaultCloseOperation()ユーザーがこのダイアログで「クローズ」を開始したときに実行される処理を返します。- 戻り値:
- ウィンドウ・クローズ・オペレーションを示す整数
- 関連項目:
-
setTransferHandler
@BeanProperty(hidden=true, description="Mechanism for transfer of data into the component") 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
- 関連項目:
-
getTransferHandler
public TransferHandler getTransferHandler()transferHandler
プロパティを取得します。- 戻り値:
transferHandler
プロパティの値- 導入されたバージョン:
- 1.6
- 関連項目:
-
update
public void update(Graphics g) paint(g)
を呼び出します。 このメソッドは、バックグラウンドをクリアする不必要な呼出しが行われないようにするためにオーバーライドされました。 -
setJMenuBar
@BeanProperty(bound=false, hidden=true, description="The menubar for accessing pulldown menus from this dialog.") public void setJMenuBar(JMenuBar menu) このダイアログのメニュー・バーを設定します。- パラメータ:
menu
- ダイアログ内に配置されているメニュー・バー- 関連項目:
-
getJMenuBar
public JMenuBar getJMenuBar()このダイアログに設定されているメニュー・バーを返します。- 戻り値:
- このダイアログで設定されたメニュー・バー
- 関連項目:
-
isRootPaneCheckingEnabled
protected boolean isRootPaneCheckingEnabled()add
およびsetLayout
の呼出しがcontentPane
に転送されるかどうかを返します。- 戻り値:
add
およびsetLayout
が転送される場合はtrue、それ以外の場合はfalse- 関連項目:
-
setRootPaneCheckingEnabled
@BeanProperty(hidden=true, description="Whether the add and setLayout methods are forwarded") protected void setRootPaneCheckingEnabled(boolean enabled) add
およびsetLayout
の呼出しがcontentPane
に転送されるかどうかを設定します。- パラメータ:
enabled
-add
およびsetLayout
が転送される場合はtrue、JDialog
で直接実行する必要がある場合はfalse。- 関連項目:
-
addImpl
指定された子Component
を追加します。 このメソッドをオーバーライドすると、呼出しが条件付きでcontentPane
に転送されます。 デフォルトでは、子はフレームではなくcontentPane
に追加されます。詳細は、RootPaneContainer
を参照してください。- オーバーライド:
addImpl
、クラスContainer
- パラメータ:
comp
- 拡張されるコンポーネントconstraints
- 遵守されるべき制約index
- インデックス- 例外:
IllegalArgumentException
-index
が無効である場合IllegalArgumentException
- コンテナの親をそのコンテナ自体に追加しようとしている場合IllegalArgumentException
- ウィンドウをコンテナに追加しようとしている場合- 関連項目:
-
remove
public void remove(Component comp) 指定されたコンポーネントをコンテナから削除します。comp
がrootPane
でない場合は、呼出しがcontentPane
に転送されます。comp
がJDialog
またはcontentPane
の子でない場合は、何も行われません。- オーバーライド:
remove
、クラスContainer
- パラメータ:
comp
- 削除されるコンポーネント- 例外:
NullPointerException
-comp
がnullである場合- 関連項目:
-
setLayout
public void setLayout(LayoutManager manager) -
getRootPane
@BeanProperty(bound=false, hidden=true, description="the RootPane object for this dialog.") public JRootPane getRootPane()このダイアログのrootPane
オブジェクトを返します。- 定義:
getRootPane
、インタフェースRootPaneContainer
- 戻り値:
- このコンポーネントの単一のJRootPaneの子。
- 関連項目:
-
setRootPane
protected void setRootPane(JRootPane root) rootPane
プロパティを設定します。 このメソッドはコンストラクタによって呼び出されます。- パラメータ:
root
- このダイアログのrootPane
オブジェクト- 関連項目:
-
getContentPane
public Container getContentPane()このダイアログのcontentPane
オブジェクトを返します。- 定義:
getContentPane
、インタフェースRootPaneContainer
- 戻り値:
contentPane
プロパティ- 関連項目:
-
setContentPane
@BeanProperty(bound=false, hidden=true, description="The client area of the dialog where child components are normally inserted.") public void setContentPane(Container contentPane) contentPane
プロパティを設定します。 このメソッドはコンストラクタによって呼び出されます。Swingのペイント・アーキテクチャでは、包含関係の階層に不透明な
JComponent
が含まれている必要があります。 通常、これはコンテンツ・ペインによって提供されます。 コンテンツ・ペインを置き換える場合は、不透明なJComponent
と置き換えることをお勧めします。- 定義:
setContentPane
、インタフェースRootPaneContainer
- パラメータ:
contentPane
- このダイアログのcontentPane
オブジェクト- 例外:
IllegalComponentStateException
- (実行時例外)コンテンツ・ペイン・パラメータがnull
の場合- 関連項目:
-
getLayeredPane
public JLayeredPane getLayeredPane()このダイアログのlayeredPane
オブジェクトを返します。- 定義:
getLayeredPane
、インタフェースRootPaneContainer
- 戻り値:
layeredPane
プロパティ- 関連項目:
-
setLayeredPane
@BeanProperty(bound=false, hidden=true, description="The pane which holds the various dialog layers.") public void setLayeredPane(JLayeredPane layeredPane) layeredPane
プロパティを設定します。 このメソッドはコンストラクタによって呼び出されます。- 定義:
setLayeredPane
、インタフェースRootPaneContainer
- パラメータ:
layeredPane
- 新しいlayeredPane
プロパティ- 例外:
IllegalComponentStateException
- 階層化ペイン・パラメータがnullの場合(実行時例外)- 関連項目:
-
getGlassPane
public Component getGlassPane()このダイアログのglassPane
オブジェクトを返します。- 定義:
getGlassPane
、インタフェースRootPaneContainer
- 戻り値:
glassPane
プロパティ- 関連項目:
-
setGlassPane
@BeanProperty(bound=false, hidden=true, description="A transparent pane used for menu rendering.") public void setGlassPane(Component glassPane) glassPane
プロパティを設定します。 このメソッドはコンストラクタによって呼び出されます。- 定義:
setGlassPane
、インタフェースRootPaneContainer
- パラメータ:
glassPane
- このダイアログのglassPane
オブジェクト- 関連項目:
-
getGraphics
@BeanProperty(bound=false) public Graphics getGraphics()このコンポーネントのグラフィックス・コンテキストを作成します。 このメソッドは、コンポーネントが現在表示可能でない場合、null
を返します。- オーバーライド:
getGraphics
、クラスComponent
- 戻り値:
- このコンポーネントのグラフィックス・コンテキスト。ない場合は
null
- 導入されたバージョン:
- 1.6
- 関連項目:
-
repaint
public void repaint(long time, int x, int y, int width, int height) このコンポーネントの指定された矩形をtime
ミリ秒以内に再ペイントします。 再ペイントの方法の詳細は、RepaintManager
を参照してください。 -
setDefaultLookAndFeelDecorated
public static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated) 新しく生成されるJDialog
が、現在のルック・アンド・フィールで実行できるボーダー、ウィンドウ・クローズ用ウィジェット、タイトルなどのウィンドウ装飾を保持するかどうかのヒントが用意されています。defaultLookAndFeelDecorated
がtrueの場合、現在のLookAndFeel
がウィンドウ装飾をサポートし、現在のウィンドウ・マネージャが装飾のないウィンドウをサポートするため、新しく生成されるJDialog
は、現在のLookAndFeel
で実行できるウィンドウ装飾を保持します。 それ以外の場合は、新しく生成されるJDialog
は現在のウィンドウ・マネージャで実行できるウィンドウ装飾を保持します。次のコードを実行すると、単一のJDialogの場合と同じ結果になります。
JDialog dialog = new JDialog(); dialog.setUndecorated(true); dialog.getRootPane().setWindowDecorationStyle(JRootPane.PLAIN_DIALOG);
- パラメータ:
defaultLookAndFeelDecorated
- 現在のルック・アンド・フィールがウィンドウ装飾を提供するかどうかのヒント- 導入されたバージョン:
- 1.4
- 関連項目:
-
isDefaultLookAndFeelDecorated
public static boolean isDefaultLookAndFeelDecorated()新しく生成されるJDialog
の現在のルック・アンド・フィールで実行できるウィンドウ装飾を保持する場合はtrueを返します。 これは単なるヒントであり、ルック・アンド・フィールがこの機能をサポートしない場合もあります。- 戻り値:
- ルック・アンド・フィールがウィンドウ修飾を提供する場合はtrue。
- 導入されたバージョン:
- 1.4
-
paramString
protected String paramString()このJDialog
の文字列表現を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、null
にはできません。- オーバーライド:
paramString
、クラスDialog
- 戻り値:
- この
JDialog
を表す文字列表現。
-
getAccessibleContext
public AccessibleContext getAccessibleContext()このJDialogに関連付けられたAccessibleContextを取得します。 JDialogの場合、AccessibleContextはAccessibleJDialogの形式を取ります。 必要に応じて新規のAccessibleJDialogインスタンスが作成されます。- 定義:
getAccessibleContext
、インタフェースAccessible
- オーバーライド:
getAccessibleContext
、クラスDialog
- 戻り値:
- このJDialogのAccessibleContextとして機能するAccessibleJDialog
-