|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
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
コンポーネントには、唯一の子として 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.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()
Frame
の指定なしで作成します。共有されて、隠れたフレームがダイアログの所有者として設定されます。public JDialog(Frame owner)
Frame
を所有者として作成します。owner
- ダイアログを表示する Frame
public JDialog(Frame owner, boolean modal)
Frame
で作成します。owner
- ダイアログを表示する Frame
modal
- モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は falsepublic JDialog(Frame owner, String title)
Frame
で作成します。owner
- ダイアログを表示する Frame
title
- ダイアログのタイトルバーに表示される String
public JDialog(Frame owner, String title, boolean modal)
Frame
で作成します。すべてのコンストラクタはこのフレームに従います。
注: モーダルダイアログ内に作成されたポップアップコンポーネント (JComboBox
、JPopupMenu
、JMenuBar
) は、軽量コンポーネントになります。
owner
- ダイアログを表示する Frame
title
- ダイアログのタイトルバーに表示される String
modal
- モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は falsepublic JDialog(Dialog owner)
Dialog
で作成します。owner
- ダイアログを表示する Dialog
public JDialog(Dialog owner, boolean modal)
owner
- ダイアログを表示する Dialog
modal
- モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は falsepublic JDialog(Dialog owner, String title)
owner
- ダイアログを表示する Dialog
title
- ダイアログのタイトルバーに表示される String
public JDialog(Dialog owner, String title, boolean modal)
owner
- ダイアログを表示する Dialog
メソッドの詳細 |
protected void dialogInit()
JDialog
を適切に初期化するためにコンストラクタによって呼び出されます。protected JRootPane createRootPane()
rootPane
を作成します。protected void processKeyEvent(KeyEvent e)
Component
内の processKeyEvent
e
- キーイベントComponent.processKeyEvent(java.awt.event.KeyEvent)
protected void processWindowEvent(WindowEvent e)
defaultCloseOperation
プロパティの状態に応じて、ウィンドウイベントを処理します。Window
内の processWindowEvent
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
java.awt.Container
からコピーされたタグ:g
- 指定された Graphics ウィンドウComponent.update(java.awt.Graphics)
public void setJMenuBar(JMenuBar menu)
menubar
- ダイアログ内に配置中のメニューバー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 BorderLayout())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 void setLocationRelativeTo(Component c)
c
- ダイアログの位置の基準となるコンポーネントprotected String paramString()
JDialog
の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null
にはなりません。Dialog
内の paramString
JDialog
の文字列表現public AccessibleContext getAccessibleContext()
Accessible
内の getAccessibleContext
Dialog
内の getAccessibleContext
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.