|
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 - ダイアログを表示する Framemodal - モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は false
HeadlessException - GraphicsEnvironment.isHeadless() が true の場合GraphicsEnvironment.isHeadless(),
JComponent.getDefaultLocale()
public JDialog(Frame owner,
String title)
throws HeadlessException
owner が null の場合、共有の非表示フレームがダイアログの所有者として設定されます。
このコンストラクタは、コンポーネントのロケールプロパティを JComponent.getDefaultLocale で返される値に設定します。
owner - ダイアログを表示する Frametitle - ダイアログのタイトルバーに表示される 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 - ダイアログを表示する Frametitle - ダイアログのタイトルバーに表示される Stringmodal - モーダルダイアログである場合は 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 - ダイアログを表示する Frametitle - ダイアログのタイトルバーに表示される Stringmodal - モーダルダイアログである場合は 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 でない Dialogmodal - モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は false
HeadlessException - GraphicsEnvironment.isHeadless() が true の場合GraphicsEnvironment.isHeadless(),
JComponent.getDefaultLocale()
public JDialog(Dialog owner,
String title)
throws HeadlessException
このコンストラクタは、コンポーネントのロケールプロパティを JComponent.getDefaultLocale で返される値に設定します。
owner - ダイアログを表示する、null でない Dialogtitle - ダイアログのタイトルバーに表示される String
HeadlessException - GraphicsEnvironment.isHeadless() が true の場合GraphicsEnvironment.isHeadless(),
JComponent.getDefaultLocale()
public JDialog(Dialog owner,
String title,
boolean modal)
throws HeadlessException
このコンストラクタは、コンポーネントのロケールプロパティを JComponent.getDefaultLocale で返される値に設定します。
owner - ダイアログを表示する、null でない Dialogtitle - ダイアログのタイトルバーに表示される Stringmodal - モーダルダイアログである場合は 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 - ダイアログを表示する Dialogtitle - ダイアログのタイトルバーに表示される Stringmodal - モーダルダイアログである場合は 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 内の processWindowEvente - ウィンドウイベント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 内の updateg - ペイント対象の 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 内の addImplcomp - 拡張対象の Componentconstraints - 遵守される制約index - インデックス (整数)
Error - rootPaneCheckingEnabled が true で呼び出された場合setRootPaneCheckingEnabled(boolean)public void remove(Component comp)
Container 内の removecomp - 削除されるコンポーネントContainer.add(java.awt.Component)public void setLayout(LayoutManager manager)
contentPane のレイアウトを設定する必要があります。次に例を示します。
thisComponent.getContentPane().setLayout(new GridLayout(1, 2))
rootPaneCheckingEnabled が true の場合、このコンポーネントにレイアウトを設定しようとすると、実行時例外がスローされます。サブクラスでこの動作を使用不可にできます。
Container 内の setLayoutmanager - LayoutManager
Error - rootPaneChecking が true で呼び出された場合setRootPaneCheckingEnabled(boolean)public JRootPane getRootPane()
rootPane オブジェクトを返します。
RootPaneContainer 内の getRootPanesetRootPane(javax.swing.JRootPane),
RootPaneContainer.getRootPane()protected void setRootPane(JRootPane root)
rootPane プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
root - このダイアログの rootPane オブジェクトgetRootPane()public Container getContentPane()
contentPane オブジェクトを返します。
RootPaneContainer 内の getContentPanecontentPane プロパティsetContentPane(java.awt.Container),
RootPaneContainer.getContentPane()public void setContentPane(Container contentPane)
contentPane プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
RootPaneContainer 内の setContentPanecontentPane - このダイアログの contentPane オブジェクト
IllegalComponentStateException - コンテンツ区画パラメータが null の場合 (実行時例外)getContentPane(),
RootPaneContainer.setContentPane(java.awt.Container)public JLayeredPane getLayeredPane()
layeredPane オブジェクトを返します。
RootPaneContainer 内の getLayeredPanelayeredPane プロパティsetLayeredPane(javax.swing.JLayeredPane),
RootPaneContainer.getLayeredPane()public void setLayeredPane(JLayeredPane layeredPane)
layeredPane プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
RootPaneContainer 内の setLayeredPanelayeredPane - 新しい layeredPane プロパティ
IllegalComponentStateException - 階層化区画パラメータが null の場合 (実行時例外)getLayeredPane(),
RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)public Component getGlassPane()
glassPane オブジェクトを返します。
RootPaneContainer 内の getGlassPaneglassPane プロパティsetGlassPane(java.awt.Component),
RootPaneContainer.getGlassPane()public void setGlassPane(Component glassPane)
glassPane プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
RootPaneContainer 内の setGlassPaneglassPane - このダイアログの 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.getSupportsWindowDecorationspublic static boolean isDefaultLookAndFeelDecorated()
JDialog の現在の Look & Feel (L&F) で実行できるウィンドウ装飾を保持する場合は true を返します。特定の Look & Feel (L&F) でこの機能をサポートしない場合は、これは単なるヒントです。
protected String paramString()
JDialog の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。
Dialog 内の paramStringJDialog の文字列表現public AccessibleContext getAccessibleContext()
Accessible 内の getAccessibleContextDialog 内の 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.