javax.swing
クラス JDialog

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

すべての実装インタフェース:

Accessible, ImageObserver, MenuContainer, RootPaneContainer, Serializable, WindowConstants

public class JDialog

extends Dialog

implements WindowConstants, Accessible, RootPaneContainer

ダイアログウィンドウを作成するためのメインクラスです。このクラスを使うと、カスタムダイアログを作成したり、JOptionPane で多くのクラスメソッドを呼び出してさまざまな標準ダイアログを作成したりすることができます。ダイアログ作成の詳細については、「The Java Tutorial」の「How to Make Dialogs」を参照してください。

JDialog コンポーネントには、唯一の子として JRootPane が格納されます。contentPane は JDialog のすべての子の親になる必要があります。従来の java.awt.Window オブジェクトからは、通常は次のように操作します。

       dialog.add(child);

JDialog を使用する際の正しい使い方は次のとおりです。

       dialog.getContentPane().add(child);

同様の原則が、レイアウトマネージャの設定、コンポーネントの削除、および子のリスト表示などでも適用されます。通常、これらのメソッドはすべて JDialog ではなく、contentPane に送る必要があります。contentPane は常に null 以外です。null に設定しようとすると、例外が生成されます。デフォルトの contentPane には BorderLayout マネージャが設定されています。

contentPane、glassPane、および layeredPane コンポーネントの詳細については、JRootPane の説明を参照してください。

標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JDialog のキーの割り当てを参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:

JOptionPane, JRootPane, 直列化された形式

内部クラスの概要

protected class

JDialog.AccessibleJDialog このクラスは JDialog クラス用のユーザ補助機能のサポートを実装しています。

クラス java.awt.Dialog から継承した内部クラス

Dialog.AccessibleAWTDialog

クラス java.awt.Window から継承した内部クラス

Window.AccessibleAWTWindow

クラス java.awt.Container から継承した内部クラス

Container.AccessibleAWTContainer

クラス java.awt.Component から継承した内部クラス

Component.AccessibleAWTComponent

フィールドの概要

protected AccessibleContext	accessibleContext
protected JRootPane	rootPane
protected boolean	rootPaneCheckingEnabled

クラス java.awt.Component から継承したフィールド

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

インタフェース javax.swing.WindowConstants から継承したフィールド

DISPOSE_ON_CLOSE, DO_NOTHING_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)
モーダルまたはモーダルでないダイアログを、タイトルなしで、指定された所有者ダイアログで作成します。

JDialog(Dialog owner, String title)
モーダルでないダイアログを、指定されたタイトルで、指定された所有者ダイアログで作成します。

JDialog(Dialog owner, String title, boolean modal)
モーダルまたはモーダルでないダイアログを、指定されたタイトルで、指定された所有者フレームで作成します。

JDialog(Frame owner)
モーダルでないダイアログを、タイトルなしで、指定された Frame を所有者として作成します。

JDialog(Frame owner, boolean modal)
モーダルまたはモーダルでないダイアログを、タイトルなしで、指定された所有者 Frame で作成します。

JDialog(Frame owner, String title)
モーダルでないダイアログを、指定されたタイトルで、指定された所有者 Frame で作成します。

JDialog(Frame owner, String title, boolean modal)
モーダルまたはモーダルでないダイアログを、指定されたタイトルで、指定された所有者 Frame で作成します。

メソッドの概要

protected void	addImpl(Component comp, Object constraints, int index) デフォルトでは、子はこのコンポーネントに直接追加できず、代わりに contentPane に追加されなければなりません。
protected JRootPane	createRootPane() コンストラクタメソッドによって呼び出され、デフォルトの rootPane を作成します。
protected void	dialogInit() JDialog を適切に初期化するためにコンストラクタによって呼び出されます。
AccessibleContext	getAccessibleContext() この JDialog に関連した AccessibleContext を返します。
Container	getContentPane() このダイアログの contentPane オブジェクトを返します。
int	getDefaultCloseOperation() ユーザがこのダイアログで「クローズ」を開始したときに実行される処理を返します。
Component	getGlassPane() このダイアログの glassPane オブジェクトを返します。
JMenuBar	getJMenuBar() このダイアログに設定されているメニューバーを返します。
JLayeredPane	getLayeredPane() このダイアログの layeredPane オブジェクトを返します。
JRootPane	getRootPane() このダイアログの rootPane オブジェクトを返します。
protected boolean	isRootPaneCheckingEnabled() add および setLayout がチェックされる必要がある場合は true を返します。
protected String	paramString() この JDialog の文字列表現を返します。
protected void	processKeyEvent(KeyEvent e) このコンポーネントで発生するキーイベントを処理し、必要な場合にはイベントを、キーイベントの通知を登録しているダイアログ内のコンポーネントに渡します。
protected void	processWindowEvent(WindowEvent e) defaultCloseOperation プロパティの状態に応じて、ウィンドウイベントを処理します。
void	remove(Component comp) コンテナから、指定されたコンポーネントを削除します。
void	setContentPane(Container contentPane) contentPane プロパティを設定します。
void	setDefaultCloseOperation(int operation) ユーザがこのダイアログで「クローズ」を開始したときに、デフォルトで実行される処理を設定します。
void	setGlassPane(Component glassPane) glassPane プロパティを設定します。
void	setJMenuBar(JMenuBar menu) このダイアログのメニューバーを設定します。
void	setLayeredPane(JLayeredPane layeredPane) layeredPane プロパティを設定します。
void	setLayout(LayoutManager manager) デフォルトでは、このコンポーネントのレイアウトは設定できず、代わりに、contentPane のレイアウトを設定しなければなりません。
void	setLocationRelativeTo(Component c) 指定されたコンポーネントとの相対位置で、ダイアログの位置を設定します。
protected void	setRootPane(JRootPane root) rootPane プロパティを設定します。
protected void	setRootPaneCheckingEnabled(boolean enabled) true の場合、add および setLayout を呼び出すと例外がスローされます。
void	update(Graphics g) paint(g) を呼び出します。

クラス java.awt.Dialog から継承したメソッド

addNotify, dispose, getTitle, hide, isModal, isResizable, setModal, setResizable, setTitle, show

クラス java.awt.Window から継承したメソッド

addWindowListener, applyResourceBundle, applyResourceBundle, finalize, getFocusOwner, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getOwnedWindows, getOwner, getToolkit, getWarningString, isShowing, pack, postEvent, processEvent, removeWindowListener, setCursor, toBack, toFront

クラス java.awt.Container から継承したメソッド

add, add, add, add, add, addContainerListener, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, removeNotify, setFont, validate, validateTree

クラス java.awt.Component から継承したメソッド

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, isLightweight, isOpaque, 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, processMouseEvent, processMouseMotionEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setDropTarget, setEnabled, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, size, toString, transferFocus

クラス java.lang.Object から継承したメソッド

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

フィールドの詳細

rootPane

protected JRootPane rootPane

関連項目:

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

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

関連項目:

isRootPaneCheckingEnabled(), setRootPaneCheckingEnabled(boolean)

accessibleContext

protected AccessibleContext accessibleContext

コンストラクタの詳細

JDialog

public JDialog()

モーダルでないダイアログを、タイトルなしで、所有者 Frame の指定なしで作成します。共有されて、隠れたフレームがダイアログの所有者として設定されます。

JDialog

public JDialog(Frame owner)

モーダルでないダイアログを、タイトルなしで、指定された Frame を所有者として作成します。

パラメータ:

owner - ダイアログを表示する Frame

JDialog

public JDialog(Frame owner,
               boolean modal)

モーダルまたはモーダルでないダイアログを、タイトルなしで、指定された所有者 Frame で作成します。

パラメータ:

owner - ダイアログを表示する Frame

modal - モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は false

JDialog

public JDialog(Frame owner,
               String title)

モーダルでないダイアログを、指定されたタイトルで、指定された所有者 Frame で作成します。

パラメータ:

owner - ダイアログを表示する Frame

title - ダイアログのタイトルバーに表示される String

JDialog

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

モーダルまたはモーダルでないダイアログを、指定されたタイトルで、指定された所有者 Frame で作成します。すべてのコンストラクタはこのフレームに従います。

注: モーダルダイアログ内に作成されたポップアップコンポーネント (JComboBox、JPopupMenu、JMenuBar) は、軽量コンポーネントになります。

パラメータ:

owner - ダイアログを表示する Frame

title - ダイアログのタイトルバーに表示される String

modal - モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は false

JDialog

public JDialog(Dialog owner)

モーダルでないダイアログを、タイトルなしで、所有者として指定された Dialog で作成します。

パラメータ:

owner - ダイアログを表示する Dialog

JDialog

public JDialog(Dialog owner,
               boolean modal)

モーダルまたはモーダルでないダイアログを、タイトルなしで、指定された所有者ダイアログで作成します。

パラメータ:

owner - ダイアログを表示する Dialog

modal - モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は false

JDialog

public JDialog(Dialog owner,
               String title)

モーダルでないダイアログを、指定されたタイトルで、指定された所有者ダイアログで作成します。

パラメータ:

owner - ダイアログを表示する Dialog

title - ダイアログのタイトルバーに表示される String

JDialog

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

モーダルまたはモーダルでないダイアログを、指定されたタイトルで、指定された所有者フレームで作成します。

パラメータ:

owner - ダイアログを表示する Dialog

メソッドの詳細

dialogInit

protected void dialogInit()

JDialog を適切に初期化するためにコンストラクタによって呼び出されます。

createRootPane

protected JRootPane createRootPane()

コンストラクタメソッドによって呼び出され、デフォルトの rootPane を作成します。

processKeyEvent

protected void processKeyEvent(KeyEvent e)

このコンポーネントで発生するキーイベントを処理し、必要な場合にはイベントを、キーイベントの通知を登録しているダイアログ内のコンポーネントに渡します。

オーバーライド:

クラス Component 内の processKeyEvent

パラメータ:

e - キーイベント

関連項目:

Component.processKeyEvent(java.awt.event.KeyEvent)

processWindowEvent

protected void processWindowEvent(WindowEvent e)

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

オーバーライド:

クラス Window 内の processWindowEvent

関連項目:

setDefaultCloseOperation(int)

setDefaultCloseOperation

public void setDefaultCloseOperation(int operation)

ユーザがこのダイアログで「クローズ」を開始したときに、デフォルトで実行される処理を設定します。以下の値を選択できます。

• DO_NOTHING_ON_CLOSE - 何も行わない - プログラムは登録されている WindowListener オブジェクトの windowClosing メソッドで処理を行う必要がある
• HIDE_ON_CLOSE - 登録されている WindowListener オブジェクトを呼び出したあとで、自動的にダイアログを隠す
• DISPOSE_ON_CLOSE - 登録されている WindowListener オブジェクトを呼び出したあとで、自動的にダイアログを隠し、破棄する

デフォルト値は HIDE_ON_CLOSE です。

関連項目:

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

getDefaultCloseOperation

public int getDefaultCloseOperation()

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

戻り値:

ウィンドウクローズ処理を示す int 値

関連項目:

setDefaultCloseOperation(int)

update

public void update(Graphics g)

paint(g) を呼び出します。このメソッドは、バックグラウンドをクリアする不必要な呼び出しが行われないようにするためにオーバーライドされました。

オーバーライド:

クラス Container 内の update

クラス java.awt.Container からコピーされたタグ:

パラメータ:

g - 指定された Graphics ウィンドウ

関連項目:

Component.update(java.awt.Graphics)

setJMenuBar

public void setJMenuBar(JMenuBar menu)

このダイアログのメニューバーを設定します。

パラメータ:

menubar - ダイアログ内に配置中のメニューバー

関連項目:

getJMenuBar()

getJMenuBar

public JMenuBar getJMenuBar()

このダイアログに設定されているメニューバーを返します。

関連項目:

setJMenuBar(javax.swing.JMenuBar)

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

add および setLayout がチェックされる必要がある場合は true を返します。

戻り値:

add および setLayout がチェックされる必要がある場合は true

関連項目:

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

setRootPaneCheckingEnabled

protected void setRootPaneCheckingEnabled(boolean enabled)

true の場合、add および setLayout を呼び出すと例外がスローされます。

関連項目:

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

addImpl

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

デフォルトでは、子はこのコンポーネントに直接追加できず、代わりに contentPane に追加されなければなりません。次に例を示します。

 thisComponent.getContentPane().add(child)

rootPaneCheckingEnabled が true の場合、このコンポーネントに直接追加しようとすると、実行時例外がスローされます。サブクラスはこの動作を無効にできます。

オーバーライド:

クラス Container 内の addImpl

パラメータ:

comp - 拡張対象の Component

constraints - 遵守されるべき制約

index - インデックス (整数)

例外:

Error - rootPaneCheckingEnabled が true で呼び出された場合

関連項目:

setRootPaneCheckingEnabled(boolean)

remove

public void remove(Component comp)

コンテナから、指定されたコンポーネントを削除します。

オーバーライド:

クラス Container 内の remove

パラメータ:

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

関連項目:

Container.add(java.awt.Component)

setLayout

public void setLayout(LayoutManager manager)

デフォルトでは、このコンポーネントのレイアウトは設定できず、代わりに、contentPane のレイアウトを設定しなければなりません。次に例を示します。

 thisComponent.getContentPane().setLayout(new BorderLayout())

rootPaneCheckingEnabled が true の場合、このコンポーネントのレイアウトを設定しようとすると、実行時例外がスローされます。サブクラスはこの動作を無効にできます。

オーバーライド:

クラス Container 内の setLayout

パラメータ:

manager - LayoutManager

例外:

Error - rootPaneChecking が true で呼び出された場合

関連項目:

setRootPaneCheckingEnabled(boolean)

getRootPane

public JRootPane getRootPane()

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

定義:

インタフェース RootPaneContainer 内の getRootPane

関連項目:

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

setRootPane

protected void setRootPane(JRootPane root)

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

パラメータ:

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

関連項目:

getRootPane()

getContentPane

public Container getContentPane()

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

定義:

インタフェース RootPaneContainer 内の getContentPane

戻り値:

contentPane プロパティ

関連項目:

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

setContentPane

public void setContentPane(Container contentPane)

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

定義:

インタフェース RootPaneContainer 内の setContentPane

パラメータ:

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

例外:

IllegalComponentStateException - コンテンツ区画パラメータが null の場合 (実行時例外)

関連項目:

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

getLayeredPane

public JLayeredPane getLayeredPane()

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

定義:

インタフェース RootPaneContainer 内の getLayeredPane

戻り値:

layeredPane プロパティ

関連項目:

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

setLayeredPane

public void setLayeredPane(JLayeredPane layeredPane)

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

定義:

インタフェース RootPaneContainer 内の setLayeredPane

パラメータ:

layeredPane - 新しい layeredPane プロパティ

例外:

IllegalComponentStateException - 階層化区画パラメータが null の場合 (実行時例外)

関連項目:

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

getGlassPane

public Component getGlassPane()

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

定義:

インタフェース RootPaneContainer 内の getGlassPane

戻り値:

glassPane プロパティ

関連項目:

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

setGlassPane

public void setGlassPane(Component glassPane)

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

定義:

インタフェース RootPaneContainer 内の setGlassPane

パラメータ:

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

関連項目:

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

setLocationRelativeTo

public void setLocationRelativeTo(Component c)

指定されたコンポーネントとの相対位置で、ダイアログの位置を設定します。現在、指定されたコンポーネントが表示されていない場合は、ダイアログは画面の中央に配置されます。

パラメータ:

c - ダイアログの位置の基準となるコンポーネント

paramString

protected String paramString()

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

オーバーライド:

クラス Dialog 内の paramString

戻り値:

この JDialog の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス Dialog 内の getAccessibleContext

戻り値:

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