|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--java.awt.Window | +--java.awt.Dialog | +--javax.swing.JDialog
ダイアログウィンドウを生成するためのメインクラスです。このクラスを使用して、カスタムダイアログを生成したり、JOptionPane
で多数のクラスメソッドを呼び出したりして、さまざまな標準ダイアログを生成できます。ダイアログの生成については、「The Java Tutorial」の「How to Make Dialogs」を参照してください。
JDialog
コンポーネントには、唯一の子として 1 つの 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
の説明を参照してください。
マルチスクリーン環境では、JDialog
を所有者とは別の画面デバイス上に生成することができます。詳細は、Frame
を参照してください。
標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、「JDialog
のキー割り当て」を参照してください。
警告:
このクラスの直列化オブジェクトは今後リリースされる Swing との互換性はありません。現在サポートされている直列化は、短期間の保管、または同じバージョンの Swing が稼働しているアプリケーション間の RMI に適しています。1.4 からは、すべての JavaBeansTM の長期間の保管が java.beans
パッケージで追加サポートされています。XMLEncoder
を参照してください。
JOptionPane
,
JRootPane
入れ子クラスの概要 | |
protected class |
JDialog.AccessibleJDialog
このクラスは JDialog クラス用のユーザ補助機能のサポートを実装しています。 |
クラス java.awt.Dialog から継承した入れ子クラス |
|
クラス java.awt.Window から継承した入れ子クラス |
|
クラス java.awt.Container から継承した入れ子クラス |
|
クラス java.awt.Component から継承した入れ子クラス |
Component.BltBufferStrategy, Component.FlipBufferStrategy |
フィールドの概要 | |
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, 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)
モーダルまたはモーダルでないダイアログを、タイトルなしで、指定された所有者ダイアログで生成します。 |
|
JDialog(Dialog owner,
String title)
モーダルでないダイアログを、指定されたタイトルで、指定された所有者ダイアログで生成します。 |
|
JDialog(Dialog owner,
String title,
boolean modal)
モーダルまたはモーダルでないダイアログを、指定されたタイトルで、指定された所有者フレームで生成します。 |
|
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 で生成します。
|
メソッドの概要 | |
protected void |
addImpl(Component comp,
Object constraints,
int index)
デフォルトでは、子はこのコンポーネントに直接追加できません。 |
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 オブジェクトを返します。 |
static boolean |
isDefaultLookAndFeelDecorated()
新しく生成される JDialog の現在の Look & Feel (L&F) で実行できるウィンドウ装飾を保持する場合は true を返します。 |
protected boolean |
isRootPaneCheckingEnabled()
add および setLayout をチェックする必要がある場合は true を返します。 |
protected String |
paramString()
この JDialog の文字列表現を返します。 |
protected void |
processWindowEvent(WindowEvent e)
defaultCloseOperation プロパティの状態に応じて、ウィンドウイベントを処理します。 |
void |
remove(Component comp)
コンテナから、指定されたコンポーネントを削除します。 |
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)
デフォルトでは、このコンポーネントのレイアウトは設定できず、代わりに、 contentPane のレイアウトを設定する必要があります。 |
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, isUndecorated, setModal, setResizable, setTitle, setUndecorated, show |
クラス java.lang.Object から継承したメソッド |
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
フィールドの詳細 |
protected JRootPane rootPane
getRootPane()
,
setRootPane(javax.swing.JRootPane)
protected boolean rootPaneCheckingEnabled
isRootPaneCheckingEnabled()
,
setRootPaneCheckingEnabled(boolean)
protected AccessibleContext accessibleContext
コンストラクタの詳細 |
public JDialog() throws HeadlessException
Frame
所有者なしで生成します。共有の非表示フレームがダイアログの所有者として設定されます。
このコンストラクタは、コンポーネントのロケールプロパティを JComponent.getDefaultLocale
で返される値に設定します。
HeadlessException
- GraphicsEnvironment.isHeadless() が true の場合GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Frame owner) throws HeadlessException
Frame
を所有者として生成します。owner
が null
の場合、共有の非表示フレームがダイアログの所有者として設定されます。
このコンストラクタは、コンポーネントのロケールプロパティを JComponent.getDefaultLocale
で返される値に設定します。
owner
- ダイアログを表示する Frame
HeadlessException
- GraphicsEnvironment.isHeadless() が true の場合GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Frame owner, boolean modal) throws HeadlessException
Frame
で生成します。owner
が null
の場合、共有の非表示フレームがダイアログの所有者として設定されます。
このコンストラクタは、コンポーネントのロケールプロパティを JComponent.getDefaultLocale
で返される値に設定します。
owner
- ダイアログを表示する Frame
modal
- モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は false
HeadlessException
- GraphicsEnvironment.isHeadless() が true の場合GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Frame owner, String title) throws HeadlessException
owner
が null
の場合、共有の非表示フレームがダイアログの所有者として設定されます。
このコンストラクタは、コンポーネントのロケールプロパティを JComponent.getDefaultLocale
で返される値に設定します。
owner
- ダイアログを表示する Frame
title
- ダイアログのタイトルバーに表示される String
HeadlessException
- GraphicsEnvironment.isHeadless() が true の場合GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Frame owner, String title, boolean modal) throws HeadlessException
Frame
で生成します。owner
が null
の場合、共有の非表示フレームがダイアログの所有者として設定されます。すべてのコンストラクタがこれに従います。
注: モーダルダイアログ内に生成されたポップアップコンポーネント (JComboBox
、JPopupMenu
、JMenuBar
) は、強制的に軽量コンポーネントになります。
このコンストラクタは、コンポーネントのロケールプロパティを JComponent.getDefaultLocale
で返される値に設定します。
owner
- ダイアログを表示する Frame
title
- ダイアログのタイトルバーに表示される String
modal
- モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は false
HeadlessException
- GraphicsEnvironment.isHeadless() が true の場合GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)
Frame
、および GraphicsConfiguration
で生成します。
注: モーダルダイアログ内に生成されたポップアップコンポーネント (JComboBox
、JPopupMenu
、JMenuBar
) は、強制的に軽量コンポーネントになります。
このコンストラクタは、コンポーネントのロケールプロパティを JComponent.getDefaultLocale
で返される値に設定します。
owner
- ダイアログを表示する Frame
title
- ダイアログのタイトルバーに表示される String
modal
- モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は falsegc
- ターゲットスクリーンデバイスの GraphicsConfiguration
。gc
が null
の場合は、同じ GraphicsConfiguration
を所有フレームとして使用
HeadlessException
- GraphicsEnvironment.isHeadless() が true の場合GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Dialog owner) throws HeadlessException
Dialog
を所有者として生成します。
このコンストラクタは、コンポーネントのロケールプロパティを JComponent.getDefaultLocale
で返される値に設定します。
owner
- ダイアログを表示する、null でない Dialog
HeadlessException
- GraphicsEnvironment.isHeadless() が true の場合GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Dialog owner, boolean modal) throws HeadlessException
このコンストラクタは、コンポーネントのロケールプロパティを JComponent.getDefaultLocale
で返される値に設定します。
owner
- ダイアログを表示する、null でない Dialog
modal
- モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は false
HeadlessException
- GraphicsEnvironment.isHeadless() が true の場合GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Dialog owner, String title) throws HeadlessException
このコンストラクタは、コンポーネントのロケールプロパティを JComponent.getDefaultLocale
で返される値に設定します。
owner
- ダイアログを表示する、null でない Dialog
title
- ダイアログのタイトルバーに表示される String
HeadlessException
- GraphicsEnvironment.isHeadless() が true の場合GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Dialog owner, String title, boolean modal) throws HeadlessException
このコンストラクタは、コンポーネントのロケールプロパティを JComponent.getDefaultLocale
で返される値に設定します。
owner
- ダイアログを表示する、null でない Dialog
title
- ダイアログのタイトルバーに表示される String
modal
- モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は false
HeadlessException
- GraphicsEnvironment.isHeadless() が true の場合GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Dialog owner, String title, boolean modal, GraphicsConfiguration gc) throws HeadlessException
Dialog
、および GraphicsConfiguration
で生成します。
注: モーダルダイアログ内に生成されたポップアップコンポーネント (JComboBox
、JPopupMenu
、JMenuBar
) は、強制的に軽量コンポーネントになります。
このコンストラクタは、コンポーネントのロケールプロパティを JComponent.getDefaultLocale
で返される値に設定します。
owner
- ダイアログを表示する Dialog
title
- ダイアログのタイトルバーに表示される String
modal
- モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は falsegc
- ターゲットスクリーンデバイスの GraphicsConfiguration
。gc
が null
の場合は、同じ GraphicsConfiguration
を所有ダイアログとして使用
HeadlessException
- GraphicsEnvironment.isHeadless() の場合GraphicsEnvironment.isHeadless()
,
returns true.
メソッドの詳細 |
protected void dialogInit()
JDialog
を適切に初期化するためにコンストラクタによって呼び出されます。
protected JRootPane createRootPane()
rootPane
を生成します。
protected void processWindowEvent(WindowEvent e)
defaultCloseOperation
プロパティの状態に応じて、ウィンドウイベントを処理します。
Window
内の processWindowEvent
e
- ウィンドウイベントsetDefaultCloseOperation(int)
public void setDefaultCloseOperation(int operation)
WindowListener
オブジェクトの windowClosing
メソッドで処理を行う必要がある
WindowListener
オブジェクトを呼び出したあとで、自動的にダイアログを隠す
WindowListener
オブジェクトを呼び出したあとで、自動的にダイアログを隠し、破棄する
デフォルト値は HIDE_ON_CLOSE です。
Window.addWindowListener(java.awt.event.WindowListener)
,
getDefaultCloseOperation()
public int getDefaultCloseOperation()
setDefaultCloseOperation(int)
public void update(Graphics g)
paint(g)
を呼び出します。このメソッドは、不必要なバックグラウンドクリアを呼び出さないためにオーバーライドされました。
Container
内の update
g
- ペイント対象の Graphics
コンテキストComponent.update(Graphics)
public void setJMenuBar(JMenuBar menu)
getJMenuBar()
public JMenuBar getJMenuBar()
setJMenuBar(javax.swing.JMenuBar)
protected boolean isRootPaneCheckingEnabled()
add
および setLayout
をチェックする必要がある場合は true を返します。
add
および setLayout
をチェックする必要がある場合は trueaddImpl(java.awt.Component, java.lang.Object, int)
,
setLayout(java.awt.LayoutManager)
,
setRootPaneCheckingEnabled(boolean)
protected void setRootPaneCheckingEnabled(boolean enabled)
add
および setLayout
を呼び出すと例外がスローされます。
addImpl(java.awt.Component, java.lang.Object, int)
,
setLayout(java.awt.LayoutManager)
,
isRootPaneCheckingEnabled()
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)
public void remove(Component comp)
Container
内の remove
comp
- 削除されるコンポーネントContainer.add(java.awt.Component)
public void setLayout(LayoutManager manager)
contentPane
のレイアウトを設定する必要があります。次に例を示します。
thisComponent.getContentPane().setLayout(new GridLayout(1, 2))
rootPaneCheckingEnabled
が true の場合、このコンポーネントにレイアウトを設定しようとすると、実行時例外がスローされます。サブクラスでこの動作を使用不可にできます。
Container
内の setLayout
manager
- LayoutManager
Error
- rootPaneChecking が true で呼び出された場合setRootPaneCheckingEnabled(boolean)
public JRootPane getRootPane()
rootPane
オブジェクトを返します。
RootPaneContainer
内の getRootPane
setRootPane(javax.swing.JRootPane)
,
RootPaneContainer.getRootPane()
protected void setRootPane(JRootPane root)
rootPane
プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
root
- このダイアログの rootPane
オブジェクトgetRootPane()
public Container getContentPane()
contentPane
オブジェクトを返します。
RootPaneContainer
内の getContentPane
contentPane
プロパティsetContentPane(java.awt.Container)
,
RootPaneContainer.getContentPane()
public void setContentPane(Container contentPane)
contentPane
プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
RootPaneContainer
内の setContentPane
contentPane
- このダイアログの contentPane
オブジェクト
IllegalComponentStateException
- コンテンツ区画パラメータが null
の場合 (実行時例外)getContentPane()
,
RootPaneContainer.setContentPane(java.awt.Container)
public JLayeredPane getLayeredPane()
layeredPane
オブジェクトを返します。
RootPaneContainer
内の getLayeredPane
layeredPane
プロパティsetLayeredPane(javax.swing.JLayeredPane)
,
RootPaneContainer.getLayeredPane()
public void setLayeredPane(JLayeredPane layeredPane)
layeredPane
プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
RootPaneContainer
内の setLayeredPane
layeredPane
- 新しい layeredPane
プロパティ
IllegalComponentStateException
- 階層化区画パラメータが null の場合 (実行時例外)getLayeredPane()
,
RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)
public Component getGlassPane()
glassPane
オブジェクトを返します。
RootPaneContainer
内の getGlassPane
glassPane
プロパティsetGlassPane(java.awt.Component)
,
RootPaneContainer.getGlassPane()
public void setGlassPane(Component glassPane)
glassPane
プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
RootPaneContainer
内の setGlassPane
glassPane
- このダイアログの glassPane
オブジェクトgetGlassPane()
,
RootPaneContainer.setGlassPane(java.awt.Component)
public static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)
JDialog
が、現在の Look & Feel (L&F) で実行できるボーダ、ウィンドウクローズ用ウィジェット、タイトルなどのウィンドウ装飾を保持するかどうかのヒントが用意されています。defaultLookAndFeelDecorated
が true の場合、現在の LookAndFeel
がウィンドウ装飾をサポートし、現在のウィンドウマネージャが装飾のないウィンドウをサポートするため、新しく生成される JDialog
は、現在の LookAndFeel
で実行できるウィンドウ装飾を保持します。この値が false の場合は、新しく生成される JDialog
は現在のウィンドウマネージャで実行できるウィンドウ装飾を保持します。
次のコードを実行すると、単一の JDialog の場合と同じ結果になります。
JDialog dialog = new JDialog(); dialog.setUndecorated(true); dialog.getRootPane().setWindowDecorationStyle(JRootPane.PLAIN_DIALOG);
defaultLookAndFeelDecorated
- 現在の Look & Feel (L&F) がウィンドウ装飾を実行できるかどうかのヒントjavax.swing.LookAndFeel.getSupportsWindowDecorations
public static boolean isDefaultLookAndFeelDecorated()
JDialog
の現在の Look & Feel (L&F) で実行できるウィンドウ装飾を保持する場合は true を返します。特定の Look & Feel (L&F) でこの機能をサポートしない場合は、これは単なるヒントです。
protected String paramString()
JDialog
の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null
にはなりません。
Dialog
内の paramString
JDialog
の文字列表現public AccessibleContext getAccessibleContext()
Accessible
内の getAccessibleContext
Dialog
内の getAccessibleContext
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.