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's Threading Policy」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。1.4以降、すべてのJavaBeans(tm)用の長期間の格納サポートがjava.beans
パッケージに追加されています。XMLEncoder
を参照してください。
JOptionPane
, JRootPane
, RootPaneContainer
修飾子と型 | クラスと説明 |
---|---|
protected class |
JDialog.AccessibleJDialog
このクラスは、
JDialog クラスのアクセシビリティ・サポートを実装しています。 |
Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType
Window.AccessibleAWTWindow, Window.Type
Container.AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
修飾子と型 | フィールドと説明 |
---|---|
protected AccessibleContext |
accessibleContext |
protected JRootPane |
rootPane |
protected boolean |
rootPaneCheckingEnabled
trueの場合は、
add およびsetLayout の呼出しがcontentPane に転送されます。 |
DEFAULT_MODALITY_TYPE
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
コンストラクタと説明 |
---|
JDialog()
タイトルがなく、所有者
Frame の指定もないモードなしダイアログを作成します。 |
JDialog(Dialog owner)
指定された
Dialog (所有者として)と空のタイトルで、モードなしダイアログを作成します。 |
JDialog(Dialog owner, boolean modal)
空のタイトル、指定されたモーダリティ、および
Dialog (所有者として)で、ダイアログを作成します。 |
JDialog(Dialog owner, String title)
指定されたタイトルと指定された所有者ダイアログで、モードなしダイアログを作成します。
|
JDialog(Dialog owner, String title, boolean modal)
タイトル、モーダリティ、所有者
Dialog で、ダイアログを作成します。 |
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 で、ダイアログを作成します。 |
JDialog(Window owner)
指定された
Window (所有者として)と空のタイトルを含むモードなしダイアログを作成します。 |
JDialog(Window owner, Dialog.ModalityType modalityType)
空のタイトル、指定されたモーダリティ、および
Window (所有者として)を含むダイアログを作成します。 |
JDialog(Window owner, String title)
タイトルと所有者
Window を指定してモードなしダイアログを作成します。 |
JDialog(Window owner, String title, Dialog.ModalityType modalityType)
指定されたタイトル、所有者
Window 、およびモーダリティで、ダイアログを作成します。 |
JDialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)
指定されたタイトル、所有者
Window 、モーダリティ、および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 オブジェクトを返します。 |
Graphics |
getGraphics()
このコンポーネントのグラフィックス・コンテキストを作成します。
|
JMenuBar |
getJMenuBar()
このダイアログに設定されているメニュー・バーを返します。
|
JLayeredPane |
getLayeredPane()
このダイアログの
layeredPane オブジェクトを返します。 |
JRootPane |
getRootPane()
このダイアログの
rootPane オブジェクトを返します。 |
TransferHandler |
getTransferHandler()
transferHandler プロパティを取得します。 |
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 |
repaint(long time, int x, int y, int width, int height)
このコンポーネントの指定された矩形を
time ミリ秒以内に再ペイントします。 |
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 |
setTransferHandler(TransferHandler newHandler)
このコンポーネントへのデータ転送をサポートするメカニズムである、
transferHandler プロパティを設定します。 |
void |
update(Graphics g)
paint(g) を呼び出します。 |
addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, setVisible, show, toBack
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, toFront
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, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTree
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, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, 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, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
protected JRootPane rootPane
protected boolean rootPaneCheckingEnabled
add
およびsetLayout
の呼出しがcontentPane
に転送されます。最初はfalseですが、JDialog
が構築されると、trueに設定されます。protected AccessibleContext accessibleContext
public JDialog()
Frame
の指定もないモードなしダイアログを作成します。共有されて、隠れたフレームがダイアログの所有者として設定されます。
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
注: このコンストラクタでは、所有者なしのJDialog
を作成することはできません。所有者なしのJDialog
を作成するには、引数null
を指定して、JDialog(Window)
コンストラクタまたはJDialog(Dialog)
コンストラクタを使用する必要があります。
HeadlessException
- GraphicsEnvironment.isHeadless()
がtrue
を返す場合。GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
public JDialog(Frame owner)
Frame
(所有者として)と空のタイトルで、モードなしダイアログを作成します。owner
がnull
の場合、共有の非表示フレームがダイアログの所有者として設定されます。
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
注: このコンストラクタでは、所有者なしのJDialog
を作成することはできません。所有者なしのJDialog
を作成するには、引数null
を指定して、JDialog(Window)
コンストラクタまたはJDialog(Dialog)
コンストラクタを使用する必要があります。
owner
- ダイアログを表示するFrame
HeadlessException
- GraphicsEnvironment.isHeadless()
がtrue
を返す場合。GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
public JDialog(Frame owner, boolean modal)
Frame
(所有者として)で、ダイアログを作成します。owner
がnull
の場合、共有の非表示フレームがダイアログの所有者として設定されます。
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
注: このコンストラクタでは、所有者なしのJDialog
を作成することはできません。所有者なしのJDialog
を作成するには、引数null
を指定して、JDialog(Window)
コンストラクタまたはJDialog(Dialog)
コンストラクタを使用する必要があります。
owner
- ダイアログを表示するFrame
modal
- ダイアログが表示されているとき、他のトップレベルのウィンドウへのユーザー入力をブロックするかどうかを指定する。true
の場合、モーダリティ・タイプ・プロパティはDEFAULT_MODALITY_TYPE
に設定される。そうでない場合は、モードなしダイアログになる。HeadlessException
- GraphicsEnvironment.isHeadless()
がtrue
を返す場合。GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
public JDialog(Frame owner, String title)
owner
がnull
の場合、共有の非表示フレームがダイアログの所有者として設定されます。
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
注: このコンストラクタでは、所有者なしのJDialog
を作成することはできません。所有者なしのJDialog
を作成するには、引数null
を指定して、JDialog(Window)
コンストラクタまたはJDialog(Dialog)
コンストラクタを使用する必要があります。
owner
- ダイアログを表示するFrame
title
- ダイアログのタイトル・バーに表示されるString
HeadlessException
- GraphicsEnvironment.isHeadless()
がtrue
を返す場合。GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
public JDialog(Frame owner, String title, boolean modal)
Frame
、およびモーダリティで、ダイアログを作成します。owner
がnull
の場合、共有の非表示フレームがダイアログの所有者として設定されます。
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
注: モーダル・ダイアログ内に作成されたポップアップ・コンポーネント(JComboBox
、JPopupMenu
、JMenuBar
)は、軽量コンポーネントになります。
注: このコンストラクタでは、所有者なしのJDialog
を作成することはできません。所有者なしのJDialog
を作成するには、引数null
を指定して、JDialog(Window)
コンストラクタまたはJDialog(Dialog)
コンストラクタを使用する必要があります。
owner
- ダイアログを表示するFrame
title
- ダイアログのタイトル・バーに表示されるString
modal
- ダイアログが表示されているとき、他のトップレベルのウィンドウへのユーザー入力をブロックするかどうかを指定する。true
の場合、モーダリティ・タイプ・プロパティはDEFAULT_MODALITY_TYPE
に設定される。そうでない場合は、モードなしダイアログになるHeadlessException
- GraphicsEnvironment.isHeadless()
がtrue
を返す場合。Dialog.ModalityType
, Dialog.ModalityType.MODELESS
, Dialog.DEFAULT_MODALITY_TYPE
, Dialog.setModal(boolean)
, Dialog.setModalityType(java.awt.Dialog.ModalityType)
, GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
public JDialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)
Frame
、モーダリティ、およびGraphicsConfiguration
で、ダイアログを作成します。owner
がnull
の場合、共有の非表示フレームがダイアログの所有者として設定されます。
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
注: モーダル・ダイアログ内に作成されたポップアップ・コンポーネント(JComboBox
、JPopupMenu
、JMenuBar
)は、軽量コンポーネントになります。
注: このコンストラクタでは、所有者なしのJDialog
を作成することはできません。所有者なしのJDialog
を作成するには、引数null
を指定して、JDialog(Window)
コンストラクタまたはJDialog(Dialog)
コンストラクタを使用する必要があります。
owner
- ダイアログを表示するFrame
title
- ダイアログのタイトル・バーに表示されるString
modal
- ダイアログが表示されているとき、他のトップレベルのウィンドウへのユーザー入力をブロックするかどうかを指定する。true
の場合、モーダリティ・タイプ・プロパティはDEFAULT_MODALITY_TYPE
に設定される。そうでない場合は、モードなしダイアログになる。gc
- ターゲット画面デバイスのGraphicsConfiguration
。null
の場合は、デフォルトのシステムGraphicsConfiguration
と見なされるHeadlessException
- GraphicsEnvironment.isHeadless()
がtrue
を返す場合。Dialog.ModalityType
, Dialog.ModalityType.MODELESS
, Dialog.DEFAULT_MODALITY_TYPE
, Dialog.setModal(boolean)
, Dialog.setModalityType(java.awt.Dialog.ModalityType)
, GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
public JDialog(Dialog owner)
Dialog
(所有者として)と空のタイトルで、モードなしダイアログを作成します。
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
owner
- ダイアログを表示する所有者Dialog
。このダイアログに所有者がいない場合はnull
HeadlessException
- if GraphicsEnvironment.isHeadless()
はtrue
を返します。GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
public JDialog(Dialog owner, boolean modal)
Dialog
(所有者として)で、ダイアログを作成します。
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
owner
- ダイアログを表示する所有者Dialog
。このダイアログに所有者がいない場合はnull
modal
- ダイアログが表示されているとき、他のトップレベルのウィンドウへのユーザー入力をブロックするかどうかを指定する。true
の場合、モーダリティ・タイプ・プロパティはDEFAULT_MODALITY_TYPE
に設定される。そうでない場合は、モードなしダイアログになる。HeadlessException
- GraphicsEnvironment.isHeadless()
がtrue
を返す場合。Dialog.ModalityType
, Dialog.ModalityType.MODELESS
, Dialog.DEFAULT_MODALITY_TYPE
, Dialog.setModal(boolean)
, Dialog.setModalityType(java.awt.Dialog.ModalityType)
, GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
public JDialog(Dialog owner, String title)
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
owner
- ダイアログを表示する所有者Dialog
。このダイアログに所有者がいない場合はnull
title
- ダイアログのタイトル・バーに表示されるString
HeadlessException
- GraphicsEnvironment.isHeadless()
がtrue
を返す場合。GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
public JDialog(Dialog owner, String title, boolean modal)
Dialog
で、ダイアログを作成します。
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
owner
- ダイアログを表示する所有者Dialog
。このダイアログに所有者がいない場合はnull
title
- ダイアログのタイトル・バーに表示されるString
modal
- ダイアログが表示されているとき、他のトップレベルのウィンドウへのユーザー入力をブロックするかどうかを指定する。true
の場合、モーダリティ・タイプ・プロパティはDEFAULT_MODALITY_TYPE
に設定される。そうでない場合は、モードなしダイアログになるHeadlessException
- GraphicsEnvironment.isHeadless()
がtrue
を返す場合。Dialog.ModalityType
, Dialog.ModalityType.MODELESS
, Dialog.DEFAULT_MODALITY_TYPE
, Dialog.setModal(boolean)
, Dialog.setModalityType(java.awt.Dialog.ModalityType)
, GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
public JDialog(Dialog owner, String title, boolean modal, GraphicsConfiguration gc)
Dialog
、モーダリティ、およびGraphicsConfiguration
で、ダイアログを作成します。
注: モーダル・ダイアログ内に作成されたポップアップ・コンポーネント(JComboBox
、JPopupMenu
、JMenuBar
)は、軽量コンポーネントになります。
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
owner
- ダイアログを表示する所有者Dialog
。このダイアログに所有者がいない場合はnull
title
- ダイアログのタイトル・バーに表示されるString
modal
- ダイアログが表示されているとき、他のトップレベルのウィンドウへのユーザー入力をブロックするかどうかを指定する。true
の場合、モーダリティ・タイプ・プロパティはDEFAULT_MODALITY_TYPE
に設定される。そうでない場合は、モードなしダイアログになるgc
- ターゲット画面デバイスのGraphicsConfiguration
。null
の場合は、デフォルトのシステムGraphicsConfiguration
と見なされるHeadlessException
- GraphicsEnvironment.isHeadless()
がtrue
を返す場合。Dialog.ModalityType
, Dialog.ModalityType.MODELESS
, Dialog.DEFAULT_MODALITY_TYPE
, Dialog.setModal(boolean)
, Dialog.setModalityType(java.awt.Dialog.ModalityType)
, GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
public JDialog(Window owner)
Window
(所有者として)と空のタイトルを含むモードなしダイアログを作成します。
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
owner
- ダイアログを表示するWindow
。このダイアログに所有者がいない場合はnull
IllegalArgumentException
- owner
がDialog
またはFrame
のインスタンスでない場合IllegalArgumentException
- owner
のGraphicsConfiguration
が画面デバイスのものでない場合HeadlessException
- GraphicsEnvironment.isHeadless()
がtrue
を返した場合GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
public JDialog(Window owner, Dialog.ModalityType modalityType)
Window
(所有者として)を含むダイアログを作成します。
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
owner
- ダイアログを表示するWindow
。このダイアログに所有者がいない場合はnull
modalityType
- ダイアログが表示されているときに、ほかのウィンドウへの入力がブロックされるかどうかを指定する。null
値とサポートされないモーダリティ・タイプはMODELESS
と同等であるIllegalArgumentException
- owner
がDialog
またはFrame
のインスタンスでない場合IllegalArgumentException
- owner
のGraphicsConfiguration
が画面デバイスのものでない場合HeadlessException
- GraphicsEnvironment.isHeadless()
がtrue
を返した場合SecurityException
- 呼出し元スレッドに、次が指定されたモーダル・ダイアログを作成するためのアクセス権がない場合: modalityType
Dialog.ModalityType
, Dialog.setModal(boolean)
, Dialog.setModalityType(java.awt.Dialog.ModalityType)
, GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
public JDialog(Window owner, String title)
Window
を指定してモードなしダイアログを作成します。
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
owner
- ダイアログを表示するWindow
。このダイアログに所有者がいない場合はnull
title
- ダイアログのタイトル・バーに表示されるString
。ダイアログにタイトルがない場合はnull
IllegalArgumentException
- owner
がDialog
またはFrame
のインスタンスでない場合IllegalArgumentException
- owner
のGraphicsConfiguration
が画面デバイスのものでない場合HeadlessException
- GraphicsEnvironment.isHeadless()
がtrue
を返した場合GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
public JDialog(Window owner, String title, Dialog.ModalityType modalityType)
Window
、およびモーダリティで、ダイアログを作成します。
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
owner
- ダイアログを表示するWindow
。このダイアログに所有者がいない場合はnull
title
- ダイアログのタイトル・バーに表示されるString
。ダイアログにタイトルがない場合はnull
modalityType
- ダイアログが表示されているときに、ほかのウィンドウへの入力がブロックされるかどうかを指定する。null
値とサポートされないモーダリティ・タイプはMODELESS
と同等であるIllegalArgumentException
- owner
がDialog
またはFrame
のインスタンスでない場合IllegalArgumentException
- owner
のGraphicsConfiguration
が画面デバイスのものでない場合HeadlessException
- GraphicsEnvironment.isHeadless()
がtrue
を返した場合SecurityException
- 呼出し元スレッドに、次が指定されたモーダル・ダイアログを作成するためのアクセス権がない場合: modalityType
Dialog.ModalityType
, Dialog.setModal(boolean)
, Dialog.setModalityType(java.awt.Dialog.ModalityType)
, GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
public JDialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)
Window
、モーダリティ、およびGraphicsConfiguration
で、ダイアログを作成します。
注: モーダル・ダイアログ内に作成されたポップアップ・コンポーネント(JComboBox
、JPopupMenu
、JMenuBar
)は、軽量コンポーネントになります。
このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocale
によって返された値に設定します。
owner
- ダイアログを表示するWindow
。このダイアログに所有者がいない場合はnull
title
- ダイアログのタイトル・バーに表示されるString
。ダイアログにタイトルがない場合はnull
modalityType
- ダイアログが表示されているときに、ほかのウィンドウへの入力がブロックされるかどうかを指定する。null
値とサポートされないモーダリティ・タイプはMODELESS
と同等であるgc
- ターゲット画面デバイスのGraphicsConfiguration
。null
の場合は、デフォルトのシステムGraphicsConfiguration
と見なされるIllegalArgumentException
- owner
がDialog
またはFrame
のインスタンスでない場合IllegalArgumentException
- owner
のGraphicsConfiguration
が画面デバイスのものでない場合HeadlessException
- GraphicsEnvironment.isHeadless()
がtrue
を返した場合SecurityException
- 呼出し元スレッドに、次が指定されたモーダル・ダイアログを作成するためのアクセス権がない場合: modalityType
Dialog.ModalityType
, Dialog.setModal(boolean)
, Dialog.setModalityType(java.awt.Dialog.ModalityType)
, GraphicsEnvironment.isHeadless()
, JComponent.getDefaultLocale()
protected void dialogInit()
JDialog
を適切に初期化するためにコンストラクタによって呼び出されます。protected JRootPane createRootPane()
rootPane
を作成するために、コンストラクタ・メソッドから呼び出されます。protected void processWindowEvent(WindowEvent e)
defaultCloseOperation
プロパティの状態に応じて、ウィンドウ・イベントを処理します。processWindowEvent
、クラス: Window
e
- ウィンドウ・イベントsetDefaultCloseOperation(int)
public void setDefaultCloseOperation(int operation)
DO_NOTHING_ON_CLOSE
(WindowConstants
に定義): 何も行わない。プログラムは登録されているWindowListener
オブジェクトのwindowClosing
メソッドで処理を行う必要がある。
HIDE_ON_CLOSE
(WindowConstants
に定義): 登録されている任意のWindowListener
オブジェクトを呼び出したあとで、自動的にダイアログを隠す。
DISPOSE_ON_CLOSE
(WindowConstants
に定義): 登録されている任意のWindowListener
オブジェクトを呼び出したあとで、自動的にダイアログを隠して破棄する。
デフォルトではHIDE_ON_CLOSE
が設定されます。このプロパティの値を変更すると、プロパティ名defaultCloseOperationでプロパティ変更イベントがトリガーされます。
注: Java仮想マシン(VM)内で最後の表示可能なウィンドウが破棄されると、VMが終了することがあります。詳細は、「AWTスレッドの問題」を参照してください。
operation
- ユーザーがダイアログを閉じるときに実行されるべき処理IllegalArgumentException
- defaultCloseOperationの値が前述の有効な値と異なる場合Window.addWindowListener(java.awt.event.WindowListener)
, getDefaultCloseOperation()
, WindowConstants
public int getDefaultCloseOperation()
setDefaultCloseOperation(int)
public void setTransferHandler(TransferHandler newHandler)
transferHandler
プロパティを設定します。コンポーネントがデータ転送操作をサポートしない場合、null
を使用します。
システム・プロパティsuppressSwingDropSupport
がfalse
(デフォルト)であり、このコンポーネント上の現在のドロップ・ターゲットがnull
であるか、ユーザー設定のドロップ・ターゲットでない場合、このメソッドはドロップ・ターゲットを次のように変更します。newHandler
がnull
の場合は、ドロップ・ターゲットをクリアします。null
でない場合は、新しいDropTarget
をインストールします。
注: JDialog
と組み合わせて使用した場合、TransferHandler
はデータのインポート機能しか提供しません。これは、データのエクスポート関連のメソッドが現在JComponent
型になっているためです。
詳細は、「The Java Tutorial」の「How to Use Drag and Drop and Data Transfer」を参照してください。
newHandler
- 新しいTransferHandler
TransferHandler
, getTransferHandler()
, Component.setDropTarget(java.awt.dnd.DropTarget)
public TransferHandler getTransferHandler()
transferHandler
プロパティを取得します。transferHandler
プロパティの値TransferHandler
, setTransferHandler(javax.swing.TransferHandler)
public void update(Graphics g)
paint(g)
を呼び出します。このメソッドは、バックグラウンドをクリアする不必要な呼出しが行われないようにするためにオーバーライドされました。update
、クラス: Container
g
- ペイント対象のGraphics
コンテキストComponent.update(Graphics)
public void setJMenuBar(JMenuBar menu)
menu
- ダイアログ内に配置されているメニュー・バーgetJMenuBar()
public JMenuBar getJMenuBar()
protected boolean isRootPaneCheckingEnabled()
add
およびsetLayout
の呼出しがcontentPane
に転送されるかどうかを返します。add
およびsetLayout
が転送される場合はtrue、それ以外の場合はfalseaddImpl(java.awt.Component, java.lang.Object, int)
, setLayout(java.awt.LayoutManager)
, setRootPaneCheckingEnabled(boolean)
, RootPaneContainer
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
protected void addImpl(Component comp, Object constraints, int index)
Component
を追加します。このメソッドをオーバーライドすると、呼出しが条件付きでcontentPane
に転送されます。デフォルトでは、子はフレームではなくcontentPane
に追加されます。詳細は、RootPaneContainer
を参照してください。addImpl
、クラス: Container
comp
- 拡張されるコンポーネントconstraints
- 遵守されるべき制約index
- インデックスIllegalArgumentException
- index
が無効である場合IllegalArgumentException
- コンテナの親をそのコンテナ自体に追加しようとしている場合IllegalArgumentException
- ウィンドウをコンテナに追加しようとしている場合setRootPaneCheckingEnabled(boolean)
, RootPaneContainer
public void remove(Component comp)
comp
がrootPane
でない場合は、呼出しがcontentPane
に転送されます。comp
がJDialog
またはcontentPane
の子でない場合は、何も行われません。remove
、クラス: Container
comp
- 削除されるコンポーネントNullPointerException
- comp
がnullである場合Container.add(java.awt.Component)
, RootPaneContainer
public void setLayout(LayoutManager manager)
setLayout
、クラス: Container
manager
- LayoutManager
setRootPaneCheckingEnabled(boolean)
, RootPaneContainer
public JRootPane getRootPane()
rootPane
オブジェクトを返します。getRootPane
、インタフェース: RootPaneContainer
setRootPane(javax.swing.JRootPane)
, RootPaneContainer.getRootPane()
protected void setRootPane(JRootPane root)
rootPane
プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。root
- このダイアログのrootPane
オブジェクトgetRootPane()
public Container getContentPane()
contentPane
オブジェクトを返します。getContentPane
、インタフェース: RootPaneContainer
contentPane
プロパティsetContentPane(java.awt.Container)
, RootPaneContainer.getContentPane()
public void setContentPane(Container contentPane)
contentPane
プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。
Swingのペイント・アーキテクチャでは、包含関係の階層に不透明なJComponent
が含まれている必要があります。通常、これはコンテンツ・ペインによって提供されます。コンテンツ・ペインを置き換える場合は、不透明なJComponent
と置き換えることをお勧めします。
setContentPane
、インタフェース: RootPaneContainer
contentPane
- このダイアログのcontentPane
オブジェクトIllegalComponentStateException
- (実行時例外)コンテンツ・ペイン・パラメータが次の場合: null
JRootPane
, getContentPane()
, RootPaneContainer.setContentPane(java.awt.Container)
public JLayeredPane getLayeredPane()
layeredPane
オブジェクトを返します。getLayeredPane
、インタフェース: RootPaneContainer
layeredPane
プロパティsetLayeredPane(javax.swing.JLayeredPane)
, RootPaneContainer.getLayeredPane()
public void setLayeredPane(JLayeredPane layeredPane)
layeredPane
プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。setLayeredPane
、インタフェース: RootPaneContainer
layeredPane
- 新しいlayeredPane
プロパティIllegalComponentStateException
- 階層化ペイン・パラメータがnullの場合(実行時例外)getLayeredPane()
, RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)
public Component getGlassPane()
glassPane
オブジェクトを返します。getGlassPane
、インタフェース: RootPaneContainer
glassPane
プロパティsetGlassPane(java.awt.Component)
, RootPaneContainer.getGlassPane()
public void setGlassPane(Component glassPane)
glassPane
プロパティを設定します。このメソッドはコンストラクタによって呼び出されます。setGlassPane
、インタフェース: RootPaneContainer
glassPane
- このダイアログのglassPane
オブジェクトgetGlassPane()
, RootPaneContainer.setGlassPane(java.awt.Component)
public Graphics getGraphics()
null
を返します。getGraphics
、クラス: Component
null
Component.paint(java.awt.Graphics)
public void repaint(long time, int x, int y, int width, int height)
time
ミリ秒以内に再ペイントします。再ペイントの方法の詳細は、RepaintManager
を参照してください。repaint
、クラス: Component
time
- 更新までの最大時間(ミリ秒単位)x
- x座標y
- y座標width
- 幅height
- 高さRepaintManager
public static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)
JDialog
が、現在のLook & Feel (L&F)で実行できるボーダー、ウィンドウ・クローズ用ウィジェット、タイトルなどのウィンドウ装飾を保持するかどうかのヒントが用意されています。defaultLookAndFeelDecorated
がtrueの場合、現在のLookAndFeel
がウィンドウ装飾をサポートし、現在のウィンドウ・マネージャが装飾のないウィンドウをサポートするため、新しく生成されるJDialog
は、現在のLookAndFeel
で実行できるウィンドウ装飾を保持します。それ以外の場合は、新しく生成されるJDialog
は現在のウィンドウ・マネージャで実行できるウィンドウ装飾を保持します。
次のコードを実行すると、単一のJDialogの場合と同じ結果になります。
JDialog dialog = new JDialog(); dialog.setUndecorated(true); dialog.getRootPane().setWindowDecorationStyle(JRootPane.PLAIN_DIALOG);
defaultLookAndFeelDecorated
- 現在のLook & Feelがウィンドウ装飾を提供するかどうかのヒントLookAndFeel.getSupportsWindowDecorations()
public static boolean isDefaultLookAndFeelDecorated()
JDialog
の現在のLook & Feel (L&F)で実行できるウィンドウ装飾を保持する場合はtrueを返します。これは単なるヒントであり、Look & Feelがこの機能をサポートしない場合もあります。protected String paramString()
JDialog
の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。返される文字列は空でもかまいませんが、null
にはできません。paramString
、クラス: Dialog
JDialog
を表す文字列表現。public AccessibleContext getAccessibleContext()
getAccessibleContext
、インタフェース: Accessible
getAccessibleContext
、クラス: Dialog
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.