モジュール java.desktop

パッケージ 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

@JavaBean(defaultProperty="JMenuBar", description="A toplevel window for creating dialog boxes.") 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に適しています。 1.4では、すべてのJavaBeansの長期ストレージのサポートがjava.beansパッケージに追加されました。 XMLEncoderを参照してください。

導入されたバージョン:

1.2

関連項目:

• JOptionPane
• JRootPane
• RootPaneContainer

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラス	説明
protected class	JDialog.AccessibleJDialog	このクラスは、JDialogクラスのアクセシビリティ・サポートを実装しています。

クラス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	accessibleContext	このJDialogに関連付けられたAccessibleContext
protected JRootPane	rootPane	contentPaneを管理するJRootPaneインスタンス。
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

インタフェース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の指定もないモードなしダイアログを作成します。
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()	ユーザーがこのダイアログで「クローズ」を開始したときに実行される処理を返します。
Component	getGlassPane()	このダイアログのglassPaneオブジェクトを返します。
Graphics	getGraphics()	このコンポーネントのグラフィックス・コンテキストを作成します。
JMenuBar	getJMenuBar()	このダイアログに設定されているメニュー・バーを返します。
JLayeredPane	getLayeredPane()	このダイアログのlayeredPaneオブジェクトを返します。
JRootPane	getRootPane()	このダイアログのrootPaneオブジェクトを返します。
TransferHandler	getTransferHandler()	transferHandlerプロパティを取得します。
static boolean	isDefaultLookAndFeelDecorated()	新しく生成されるJDialogの現在のルック・アンド・フィールで実行できるウィンドウ装飾を保持する場合は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)	ユーザーがこのダイアログの「クローズ」を開始したときに、デフォルトで実行される処理を設定します。
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	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, 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

クラスjava.lang.Objectで宣言されたメソッド

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

フィールド詳細

rootPane

protected JRootPane rootPane

contentPaneを管理するJRootPaneインスタンス。

関連項目:

• 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に関連付けられた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。nullの場合は、デフォルトのシステム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 - if 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。nullの場合は、デフォルトのシステム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

例外:

IllegalArgumentException - ownerがDialogまたはFrameのインスタンスでない場合

IllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合

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と同等である

例外:

IllegalArgumentException - ownerがDialogまたはFrameのインスタンスでない場合

IllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合

HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合

SecurityException - 呼出し元スレッドに、modalityTypeが指定されたモーダル・ダイアログを作成するためのアクセス権がない場合

導入されたバージョン:

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

例外:

IllegalArgumentException - ownerがDialogまたはFrameのインスタンスでない場合

IllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合

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と同等である

例外:

IllegalArgumentException - ownerがDialogまたはFrameのインスタンスでない場合

IllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合

HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合

SecurityException - 呼出し元スレッドに、modalityTypeが指定されたモーダル・ダイアログを作成するためのアクセス権がない場合

導入されたバージョン:

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と見なされる

例外:

IllegalArgumentException - ownerがDialogまたはFrameのインスタンスでない場合

IllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合

HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合

SecurityException - 呼出し元スレッドに、modalityTypeが指定されたモーダル・ダイアログを作成するためのアクセス権がない場合

導入されたバージョン:

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を作成するために、コンストラクタ・メソッドから呼び出されます。

戻り値:

新しいJRootPane。

processWindowEvent

protected void processWindowEvent(WindowEvent e)

defaultCloseOperationプロパティの状態に応じて、ウィンドウ・イベントを処理します。

オーバーライド:

processWindowEvent、クラスWindow

パラメータ:

e - ウィンドウ・イベント

関連項目:

• setDefaultCloseOperation(int)

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の値が前述の有効な値と異なる場合

関連項目:

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

getDefaultCloseOperation

public int getDefaultCloseOperation()

ユーザーがこのダイアログで「クローズ」を開始したときに実行される処理を返します。

戻り値:

ウィンドウ・クローズ・オペレーションを示す整数

関連項目:

• setDefaultCloseOperation(int)

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

関連項目:

• 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)を呼び出します。 このメソッドは、バックグラウンドをクリアする不必要な呼出しが行われないようにするためにオーバーライドされました。

オーバーライド:

update、クラスContainer

パラメータ:

g - ペイント対象のGraphicsコンテキスト

関連項目:

• Component.update(Graphics)

setJMenuBar

@BeanProperty(bound=false, hidden=true, description="The menubar for accessing pulldown menus from this dialog.") 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

@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(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を参照してください。

オーバーライド:

addImpl、クラスContainer

パラメータ:

comp - 拡張されるコンポーネント

constraints - 遵守されるべき制約

index - インデックス

例外:

IllegalArgumentException - indexが無効である場合

IllegalArgumentException - コンテナの親をそのコンテナ自体に追加しようとしている場合

IllegalArgumentException - ウィンドウをコンテナに追加しようとしている場合

関連項目:

• setRootPaneCheckingEnabled(boolean)
• RootPaneContainer

remove

public void remove(Component comp)

指定されたコンポーネントをコンテナから削除します。 compがrootPaneでない場合は、呼出しがcontentPaneに転送されます。 compがJDialogまたはcontentPaneの子でない場合は、何も行われません。

オーバーライド:

remove、クラスContainer

パラメータ:

comp - 削除されるコンポーネント

例外:

NullPointerException - compがnullである場合

関連項目:

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

setLayout

public void setLayout(LayoutManager manager)

LayoutManagerを設定します。 オーバーライドすると、呼出しが条件付きでcontentPaneに転送されます。 詳細は、RootPaneContainerを参照してください。

オーバーライド:

setLayout、クラスContainer

パラメータ:

manager - LayoutManager

関連項目:

• setRootPaneCheckingEnabled(boolean)
• RootPaneContainer

getRootPane

@BeanProperty(bound=false, hidden=true, description="the RootPane object for this dialog.") public JRootPane getRootPane()

このダイアログのrootPaneオブジェクトを返します。

定義:

getRootPane、インタフェースRootPaneContainer

戻り値:

このコンポーネントの単一のJRootPaneの子。

関連項目:

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

setRootPane

protected void setRootPane(JRootPane root)

rootPaneプロパティを設定します。 このメソッドはコンストラクタによって呼び出されます。

パラメータ:

root - このダイアログのrootPaneオブジェクト

関連項目:

• getRootPane()

getContentPane

public Container getContentPane()

このダイアログのcontentPaneオブジェクトを返します。

定義:

getContentPane、インタフェースRootPaneContainer

戻り値:

contentPaneプロパティ

関連項目:

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

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の場合

関連項目:

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

getLayeredPane

public JLayeredPane getLayeredPane()

このダイアログのlayeredPaneオブジェクトを返します。

定義:

getLayeredPane、インタフェースRootPaneContainer

戻り値:

layeredPaneプロパティ

関連項目:

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

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の場合(実行時例外)

関連項目:

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

getGlassPane

public Component getGlassPane()

このダイアログのglassPaneオブジェクトを返します。

定義:

getGlassPane、インタフェースRootPaneContainer

戻り値:

glassPaneプロパティ

関連項目:

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

setGlassPane

@BeanProperty(bound=false, hidden=true, description="A transparent pane used for menu rendering.") public void setGlassPane(Component glassPane)

glassPaneプロパティを設定します。 このメソッドはコンストラクタによって呼び出されます。

定義:

setGlassPane、インタフェースRootPaneContainer

パラメータ:

glassPane - このダイアログのglassPaneオブジェクト

関連項目:

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

getGraphics

@BeanProperty(bound=false) public Graphics getGraphics()

このコンポーネントのグラフィックス・コンテキストを作成します。 このメソッドは、コンポーネントが現在表示可能でない場合、nullを返します。

オーバーライド:

getGraphics、クラスComponent

戻り値:

このコンポーネントのグラフィックス・コンテキスト。ない場合はnull

導入されたバージョン:

1.6

関連項目:

• Component.paint(java.awt.Graphics)

repaint

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

このコンポーネントの指定された矩形をtimeミリ秒以内に再ペイントします。 再ペイントの方法の詳細は、RepaintManagerを参照してください。

オーバーライド:

repaint、クラスComponent

パラメータ:

time - 更新までの最大時間(ミリ秒単位)

x - x座標

y - y座標

width - 幅

height - 高さ

導入されたバージョン:

1.6

関連項目:

• 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

関連項目:

• LookAndFeel.getSupportsWindowDecorations()

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