|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--java.awt.Window | +--java.awt.Dialog | +--javax.swing.JDialog
ダイアログウィンドウを作成するためのメインクラスです。このクラスを使うと、カスタムダイアログを作成したり、JOptionPane で多くの static メソッドを呼び出してさまざまな標準ダイアログを作成したりすることができます。
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 の説明を参照してください。
注: バージョン 1.1 では、AWT1.1 のウィンドウ所有権の制限のために、現在、Modal ダイアログは軽量ポップアップメニュー (JPopupMenu、JComboBox、JMenuBar) を許可するだけに制約されています。このためさらに、モーダルダイアログで Swing ポップアップコンポーネントと AWT の重量コンポーネントとを混在させることができないという制約が生じています。これは、重量コンポーネントは常に軽量コンポーネントをオーバーラップするので、ポップアップメニューが隠れてしまうことがあるためです。重量コンポーネントは、実装に対してネイティブなプラットフォームであるコンポーネント (ピアコンポーネント) を使用します。AWT コンポーネントは重量コンポーネントです。
標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JDialog のキーの割り当てを参照してください。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。
JOptionPane
,
JRootPane
, 直列化された形式内部クラスの概要 | |
protected class |
JDialog.AccessibleJDialog
オブジェクトのユーザ補助機能を取得するのに使用されるクラスです。 |
フィールドの概要 | |
protected AccessibleContext |
accessibleContext
|
protected JRootPane |
rootPane
|
protected boolean |
rootPaneCheckingEnabled
|
クラス java.awt.Component から継承したフィールド |
BOTTOM_ALIGNMENT,
CENTER_ALIGNMENT,
LEFT_ALIGNMENT,
RIGHT_ALIGNMENT,
TOP_ALIGNMENT |
コンストラクタの概要 | |
JDialog()
モーダルでないダイアログを、タイトルなしで、指定されたオーナフレームなしで作成します。 |
|
JDialog(Frame owner)
モーダルでないダイアログを、タイトルなしで、指定されたフレームをオーナとして作成します。 |
|
JDialog(Frame owner,
boolean modal)
モーダルまたはモーダルでないダイアログを、タイトルなしで、指定されたオーナフレームで作成します。 |
|
JDialog(Frame owner,
String title)
モーダルでないダイアログを、指定されたタイトルで、指定されたオーナフレームで作成します。 |
|
JDialog(Frame owner,
String title,
boolean modal)
モーダルまたはモーダルでないダイアログを、指定されたタイトルで、指定されたオーナフレームで作成します。 |
メソッドの概要 | |
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()
|
protected String |
paramString()
この JDialog の文字列表現を返します。 |
protected void |
processWindowEvent(WindowEvent e)
defaultCloseOperation プロパティの状態に応じて、ウィンドウイベントを処理します。 |
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,
getTitle,
isModal,
isResizable,
setModal,
setResizable,
setTitle,
show |
クラス java.awt.Window から継承したメソッド |
addWindowListener,
applyResourceBundle,
applyResourceBundle,
dispose,
finalize,
getFocusOwner,
getInputContext,
getLocale,
getOwnedWindows,
getOwner,
getToolkit,
getWarningString,
isShowing,
pack,
postEvent,
processEvent,
removeWindowListener,
toBack,
toFront |
クラス 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()
public JDialog(Frame owner)
owner
- ダイアログを表示するフレームpublic JDialog(Frame owner, boolean modal)
owner
- ダイアログを表示するフレームmodal
- モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は falsepublic JDialog(Frame owner, String title)
owner
- ダイアログを表示するフレームtitle
- ダイアログのタイトルバーに表示される文字列public JDialog(Frame owner, String title, boolean modal)
注: モーダルダイアログ内に作成されたポップアップコンポーネント (JComboBox、JPopupMenu、JMenuBar) は、軽量コンポーネントになります。
owner
- ダイアログを表示するフレームtitle
- ダイアログのタイトルバーに表示される文字列modal
- モーダルダイアログである場合は true。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は falseメソッドの詳細 |
protected void dialogInit()
protected JRootPane createRootPane()
protected void processWindowEvent(WindowEvent e)
defaultCloseOperation
プロパティの状態に応じて、ウィンドウイベントを処理します。setDefaultCloseOperation(int)
public void setDefaultCloseOperation(int operation)
デフォルト値は HIDE_ON_CLOSE です。
Window.addWindowListener(java.awt.event.WindowListener)
,
getDefaultCloseOperation()
public int getDefaultCloseOperation()
setDefaultCloseOperation(int)
public void update(Graphics g)
paint(g)
を呼び出すだけです。このメソッドは、バックグラウンドのクリアのための不必要な呼び出しが行われないようにするためにオーバーライドされました。public void setJMenuBar(JMenuBar menu)
menu
- ダイアログに配置されるメニューバーgetJMenuBar()
public JMenuBar getJMenuBar()
setJMenuBar(javax.swing.JMenuBar)
protected boolean isRootPaneCheckingEnabled()
addImpl(java.awt.Component, java.lang.Object, int)
,
setLayout(java.awt.LayoutManager)
,
setRootPaneCheckingEnabled(boolean)
protected void setRootPaneCheckingEnabled(boolean enabled)
addImpl(java.awt.Component, java.lang.Object, int)
,
setLayout(java.awt.LayoutManager)
,
isRootPaneCheckingEnabled()
protected void addImpl(Component comp, Object constraints, int index)
thisComponent.getContentPane().add(child)直接このコンポーネントに追加しようとすると、実行時例外がスローされます。サブクラスはこの動作を無効にすることができます。
setRootPaneCheckingEnabled(boolean)
public void setLayout(LayoutManager manager)
thisComponent.getContentPane().setLayout(new BorderLayout())このコンポーネントの配置を設定しようとすると、実行時例外がスローされます。サブクラスはこの動作を無効にすることができます。
setRootPaneCheckingEnabled(boolean)
public JRootPane getRootPane()
setRootPane(javax.swing.JRootPane)
,
RootPaneContainer.getRootPane()
protected void setRootPane(JRootPane root)
root
- このダイアログの rootPane オブジェクトgetRootPane()
public Container getContentPane()
setContentPane(java.awt.Container)
,
RootPaneContainer.getContentPane()
public void setContentPane(Container contentPane)
contentPane
- このダイアログの contentPane オブジェクトgetContentPane()
,
RootPaneContainer.setContentPane(java.awt.Container)
public JLayeredPane getLayeredPane()
setLayeredPane(javax.swing.JLayeredPane)
,
RootPaneContainer.getLayeredPane()
public void setLayeredPane(JLayeredPane layeredPane)
layeredPane
- このダイアログの layeredPane オブジェクトgetLayeredPane()
,
RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)
public Component getGlassPane()
setGlassPane(java.awt.Component)
,
RootPaneContainer.getGlassPane()
public void setGlassPane(Component glassPane)
glassPane
- このダイアログの glassPane オブジェクトgetGlassPane()
,
RootPaneContainer.setGlassPane(java.awt.Component)
public void setLocationRelativeTo(Component c)
c
- ダイアログの位置の基準となるコンポーネントprotected String paramString()
null
にはなりません。
JFC コンポーネントの新しい側面についての情報を返すには、paramString() をオーバーライドします。
public AccessibleContext getAccessibleContext()
|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |