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 に適しています。1.4 以降、すべての JavaBeans^TM 用の長期間の格納サポートが java.beans パッケージに追加されています。XMLEncoder を参照してください。

関連項目:

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
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() ユーザーがこのダイアログで「クローズ」を開始したときに実行される処理を返します。
Component	getGlassPane() このダイアログの glassPane オブジェクトを返します。
Graphics	getGraphics() このコンポーネントのグラフィックスコンテキストを作成します。
JMenuBar	getJMenuBar() このダイアログに設定されているメニューバーを返します。
JLayeredPane	getLayeredPane() このダイアログの layeredPane オブジェクトを返します。
JRootPane	getRootPane() このダイアログの rootPane オブジェクトを返します。
TransferHandler	getTransferHandler() transferHandler プロパティーを取得します。
static boolean	isDefaultLookAndFeelDecorated() 新しく生成される JDialog の現在の Look & Feel (L&F) で実行できるウィンドウ装飾を保持する場合は 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 が、現在の Look & Feel (L&F) で実行できるボーダー、ウィンドウクローズ用ウィジェット、タイトルなどのウィンドウ装飾を保持するかどうかのヒントが用意されています。
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, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, 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, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, 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, 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, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, 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

関連項目:

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

processWindowEvent

protected void processWindowEvent(WindowEvent e)

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

オーバーライド:

processWindowEvent、クラス: Window

パラメータ:

e - ウィンドウイベント

関連項目:

setDefaultCloseOperation(int)

setDefaultCloseOperation

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

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

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

オーバーライド:

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

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

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

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

public void setGlassPane(Component glassPane)

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

定義:

setGlassPane、インタフェース: RootPaneContainer

パラメータ:

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

関連項目:

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

getGraphics

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 が、現在の Look & Feel (L&F) で実行できるボーダー、ウィンドウクローズ用ウィジェット、タイトルなどのウィンドウ装飾を保持するかどうかのヒントが用意されています。defaultLookAndFeelDecorated が true の場合、現在の LookAndFeel がウィンドウ装飾をサポートし、現在のウィンドウマネージャーが装飾のないウィンドウをサポートするため、新しく生成される JDialog は、現在の LookAndFeel で実行できるウィンドウ装飾を保持します。それ以外の場合は、新しく生成される JDialog は現在のウィンドウマネージャーで実行できるウィンドウ装飾を保持します。

次のコードを実行すると、単一の JDialog の場合と同じ結果になります。

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

パラメータ:

defaultLookAndFeelDecorated - 現在の Look & Feel がウィンドウ装飾を提供するかどうかのヒント

導入されたバージョン:

1.4

関連項目:

LookAndFeel.getSupportsWindowDecorations()

isDefaultLookAndFeelDecorated

public static boolean isDefaultLookAndFeelDecorated()

新しく生成される JDialog の現在の Look & Feel (L&F) で実行できるウィンドウ装飾を保持する場合は true を返します。これは単なるヒントであり、Look & Feel がこの機能をサポートしない場合もあります。

戻り値:

Look & Feel がウィンドウ修飾を提供する場合は true。

導入されたバージョン:

1.4

paramString

protected String paramString()

この JDialog の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。返される文字列は空でもかまいませんが、null にはできません。

オーバーライド:

paramString、クラス: Dialog

戻り値:

この JDialog を表す文字列表現。

getAccessibleContext

public AccessibleContext getAccessibleContext()

この JDialog に関連付けられた AccessibleContext を取得します。JDialog の場合、AccessibleContext は AccessibleJDilalog の形式を取ります。必要に応じて新規の AccessibleJDialog インスタンスが作成されます。

定義:

getAccessibleContext、インタフェース: Accessible

オーバーライド:

getAccessibleContext、クラス: Dialog

戻り値:

この JDialog の AccessibleContext として機能する AccessibleJDialog