javax.swing
クラス JDialog

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

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

ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants

public class JDialog
extends Dialog
implements WindowConstants, Accessible, RootPaneContainer

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

JDialog コンポーネントには、JRootPane が唯一の子として格納されます。contentPane は、JDialog のすべての子の親になります。便宜上、add とその派生メソッド、remove および setLayout は、必要に応じて contentPane に転送されるようにオーバーライドされています。つまり、次のように記述できます。

dialog.add(child);

子は contentPane に追加されます。contentPane は常に null 以外になります。これを null に設定しようとすると、例外が生成されます。デフォルトの contentPane には、BorderLayout マネージャが設定されています。JDialog の LayoutManager の追加、削除、および設定の詳細については、RootPaneContainer を参照してください。

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

マルチスクリーン環境では、JDialog を所有者とは別の画面デバイス上に生成することができます。詳細は、Frame を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK バージョン 1.4 以降は、java.beans パッケージですべての JavaBeans^™ の長期記憶がサポートされます。XMLEncoder を参照してください。

関連項目:

JOptionPane, JRootPane, RootPaneContainer

入れ子のクラスの概要

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, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドの概要

protected AccessibleContext	accessibleContext
protected JRootPane	rootPane
protected boolean	rootPaneCheckingEnabled true の場合は、add および setLayout の呼び出しが contentPane に転送されます。

クラス 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) 指定された子 Component を追加します。
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 の呼び出しが contentPane に転送されるかどうかを返します。
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) LayoutManager を設定します。
protected void	setRootPane(JRootPane root) rootPane プロパティを設定します。
protected void	setRootPaneCheckingEnabled(boolean enabled) add および setLayout の呼び出しが contentPane に転送されるかどうかを設定します。
void	update(Graphics g) paint(g) を呼び出します。

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

addNotify, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setResizable, setTitle, setUndecorated, show

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

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, finalize, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, isActive, isAlwaysOnTop, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setAlwaysOnTop, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationByPlatform, setLocationRelativeTo, toBack, toFront

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

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusBackward, transferFocusDownCycle, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, 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, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, size, toString, transferFocus, transferFocusUpCycle

クラス 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

true の場合は、add および setLayout の呼び出しが contentPane に転送されます。最初は false ですが、JDialog が構築されると、true に設定されます。

関連項目:

isRootPaneCheckingEnabled(), setRootPaneCheckingEnabled(boolean), RootPaneContainer

accessibleContext

protected AccessibleContext accessibleContext

コンストラクタの詳細

JDialog

public JDialog()
        throws HeadlessException

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

このコンストラクタはコンポーネントのローカルプロパティを JComponent.getDefaultLocale によって返された値に設定します。

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Frame owner)
        throws HeadlessException

モーダルでないダイアログを、タイトルなしで、指定された Frame を所有者として生成します。owner が null の場合、共有の非表示フレームがダイアログの所有者として設定されます。

このコンストラクタはコンポーネントのローカルプロパティを JComponent.getDefaultLocale によって返された値に設定します。

パラメータ:

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

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

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()

JDialog

public JDialog(Frame owner,
               String title)
        throws HeadlessException

モーダルでないダイアログを、指定されたタイトルで、指定された所有者フレームで生成します。owner が null の場合、共有の非表示フレームがダイアログの所有者として設定されます。

このコンストラクタはコンポーネントのローカルプロパティを JComponent.getDefaultLocale によって返された値に設定します。

パラメータ:

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

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

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

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()

JDialog

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

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

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

このコンストラクタはコンポーネントのローカルプロパティを JComponent.getDefaultLocale によって返された値に設定します。

パラメータ:

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

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

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

gc - ターゲットスクリーンデバイスの GraphicsConfiguration。gc が null の場合は、同じ GraphicsConfiguration を所有フレームとして使用

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

導入されたバージョン:

1.4

関連項目:

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Dialog owner)
        throws HeadlessException

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

このコンストラクタはコンポーネントのローカルプロパティを JComponent.getDefaultLocale によって返された値に設定します。

パラメータ:

owner - ダイアログを表示する、null でない Dialog

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Dialog owner,
               boolean modal)
        throws HeadlessException

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

このコンストラクタはコンポーネントのローカルプロパティを JComponent.getDefaultLocale によって返された値に設定します。

パラメータ:

owner - ダイアログを表示する、null でない Dialog

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

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Dialog owner,
               String title)
        throws HeadlessException

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

このコンストラクタはコンポーネントのローカルプロパティを JComponent.getDefaultLocale によって返された値に設定します。

パラメータ:

owner - ダイアログを表示する、null でない Dialog

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

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

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()

JDialog

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。アクティブなときにほかのウィンドウが同時にアクティブになることができるダイアログである場合は false

gc - ターゲットスクリーンデバイスの GraphicsConfiguration。gc が null の場合は、同じ GraphicsConfiguration を所有ダイアログとして使用

例外:

HeadlessException - GraphicsEnvironment.isHeadless() の場合

導入されたバージョン:

1.4

関連項目:

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

メソッドの詳細

dialogInit

protected void dialogInit()

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

createRootPane

protected JRootPane createRootPane()

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

processWindowEvent

protected void processWindowEvent(WindowEvent e)

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

オーバーライド:

クラス Window 内の processWindowEvent

パラメータ:

e - ウィンドウイベント

関連項目:

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 が設定されます。

注: Java 仮想マシン (VM) 内で最後の表示可能なウィンドウが破棄されると、VM が終了することがあります。詳細については、「AWT Threading Issues」を参照してください。

関連項目:

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

getDefaultCloseOperation

public int getDefaultCloseOperation()

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

戻り値:

ウィンドウクローズオペレーションを示す整数

関連項目:

setDefaultCloseOperation(int)

update

public void update(Graphics g)

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

オーバーライド:

クラス Container 内の update

パラメータ:

g - ペイント対象の Graphics コンテキスト

関連項目:

Component.update(Graphics)

setJMenuBar

public void setJMenuBar(JMenuBar menu)

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

パラメータ:

menu - ダイアログ内に配置されているメニューバー

関連項目:

getJMenuBar()

getJMenuBar

public JMenuBar getJMenuBar()

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

関連項目:

setJMenuBar(javax.swing.JMenuBar)

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

add および setLayout の呼び出しが contentPane に転送されるかどうかを返します。

戻り値:

add および setLayout が転送される場合は true、そうでない場合は false

関連項目:

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

setRootPaneCheckingEnabled

protected void setRootPaneCheckingEnabled(boolean enabled)

add および setLayout の呼び出しが contentPane に転送されるかどうかを設定します。

パラメータ:

enabled - add および setLayout が転送される場合は true、JDialog で直接実行する必要がある場合は false

関連項目:

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

addImpl

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

指定された子 Component を追加します。このメソッドをオーバーライドすると、呼び出しが条件付きで contentPane に転送されます。デフォルトでは、子はフレームではなく contentPane に追加されます。詳細については、RootPaneContainer を参照してください。

オーバーライド:

クラス Container 内の addImpl

パラメータ:

comp - 拡張されるコンポーネント

constraints - 遵守されるべき制約

index - インデックス

例外:

IllegalArgumentException - index が無効な場合

IllegalArgumentException - コンテナの親をそのコンテナ自体に追加しようとしている場合

IllegalArgumentException - ウィンドウをコンテナに追加しようとしている場合

関連項目:

setRootPaneCheckingEnabled(boolean), RootPaneContainer

remove

public void remove(Component comp)

指定されたコンポーネントをコンテナから削除します。comp が rootPane でない場合は、呼び出しが contentPane に転送されます。comp が JDialog または contentPane の子でない場合は、何も行われません。

オーバーライド:

クラス Container 内の remove

パラメータ:

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

例外:

NullPointerException - comp が null の場合

関連項目:

Container.add(java.awt.Component), RootPaneContainer

setLayout

public void setLayout(LayoutManager manager)

LayoutManager を設定します。このメソッドをオーバーライドすると、呼び出しが条件付きで contentPane に転送されます。詳細については、RootPaneContainer を参照してください。

オーバーライド:

クラス Container 内の setLayout

パラメータ:

manager - LayoutManager

関連項目:

setRootPaneCheckingEnabled(boolean), RootPaneContainer

getRootPane

public JRootPane getRootPane()

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

定義:

インタフェース RootPaneContainer 内の getRootPane

戻り値:

このコンポーネントの単一の JRootPane の子

関連項目:

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 プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。

Swing のペイント アーキテクチャでは、包含関係の階層に不透明な JComponent が含まれている必要があります。通常、これはコンテンツ区画よって提供されます。コンテンツ区画を置き換える場合は、不透明な JComponent と置き換えることをお勧めします。

定義:

インタフェース RootPaneContainer 内の setContentPane

パラメータ:

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

例外:

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

関連項目:

JRootPane, 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)

setDefaultLookAndFeelDecorated

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 がウィンドウ修飾を提供するかどうかについてのヒント

導入されたバージョン:

1.4

関連項目:

LookAndFeel.getSupportsWindowDecorations()

isDefaultLookAndFeelDecorated

public static boolean isDefaultLookAndFeelDecorated()

新しく生成される JDialog の現在の Look & Feel (L&F) で実行できるウィンドウ装飾を保持する場合は true を返します。特定の Look & Feel (L&F) でこの機能をサポートしない場合は、これは単なるヒントです。

戻り値:

Look & Feel がウィンドウ修飾を提供する場合は true

導入されたバージョン:

1.4

paramString

protected String paramString()

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

オーバーライド:

クラス Dialog 内の paramString

戻り値:

この JDialog の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス Dialog 内の getAccessibleContext

戻り値:

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