JavaTM Platform
Standard Ed. 6

java.awt
クラス Dialog

java.lang.Object
  上位を拡張 java.awt.Component
      上位を拡張 java.awt.Container
          上位を拡張 java.awt.Window
              上位を拡張 java.awt.Dialog
すべての実装されたインタフェース:
ImageObserver, MenuContainer, Serializable, Accessible
直系の既知のサブクラス:
FileDialog, JDialog

public class Dialog
extends Window

Dialog は、タイトルおよびボーダーを持つトップレベルのウィンドウであり、通常はユーザーからの入力を受け付けるために使用されます。 ダイアログのサイズには、ボーダーのために指定された領域が含まれます。ボーダー領域の寸法は getInsets メソッドを使うことにより取得できます。 ただし、ボーダー領域の寸法はプラットフォームに依存するので、pack または show のどちらかを呼び出すことによりダイアログを表示可能にしないと正確なインセット値は取得できません。ボーダー領域はダイアログ全体のサイズに含まれているため、ダイアログの一部が不明瞭になります。 このため、サブコンポーネントを描画および表示するための領域は、左上隅の位置が (insets.left, insets.top) であり、幅 width - (insets.left + insets.right)、高さ height - (insets.top + insets.bottom) の矩形に制限されます。  

ダイアログのデフォルトのレイアウトは BorderLayout です。  

ダイアログはネイティブな装飾 (Frame と Titlebar) を持つことができ、setUndecorated でこれを無効化できます。ダイアログが displayable の状態でないときにだけ無効化できます。  

ダイアログの作成時には、ダイアログはその所有者として別のウィンドウを持つことができます。表示されているダイアログの所有者ウィンドウが非表示になった場合や最小化された場合、そのダイアログは自動的にユーザーに対して表示されなくなります。オーナウィンドウがまた開かれると、ダイアログは再びユーザーに対して表示されます。  

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

ダイアログは、モードなし (デフォルト) またはモーダルのどちらかになります。モーダルダイアログの場合、そのダイアログを所有者として生成されたウィンドウを除き、アプリケーションのほかの一部のトップレベルウィンドウに対して入力ができなくなります。詳細は、「AWT Modality」の仕様を参照してください。  

ダイアログは、WindowOpenedWindowClosingWindowClosedWindowActivatedWindowDeactivatedWindowGainedFocus、および WindowLostFocusWindowEvents を生成できます。

導入されたバージョン:
JDK1.0
関連項目:
WindowEvent, Window.addWindowListener(java.awt.event.WindowListener), 直列化された形式

入れ子のクラスの概要
protected  class Dialog.AccessibleAWTDialog
          このクラスは Dialog クラス用のユーザー補助機能のサポートを実装しています。
static class Dialog.ModalExclusionType
          どのトップレベルウィンドウも、モーダルダイアログによってブロックされないようにマークすることができます。
static class Dialog.ModalityType
          モーダルダイアログは、一部のトップレベルウィンドウに対してすべての入力をブロックします。
 
クラス java.awt.Window から継承された入れ子のクラス/インタフェース
Window.AccessibleAWTWindow
 
クラス java.awt.Container から継承された入れ子のクラス/インタフェース
Container.AccessibleAWTContainer
 
クラス java.awt.Component から継承された入れ子のクラス/インタフェース
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
フィールドの概要
static Dialog.ModalityType DEFAULT_MODALITY_TYPE
          モーダルダイアログのデフォルトのモーダリティータイプ。
 
クラス java.awt.Component から継承されたフィールド
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
インタフェース java.awt.image.ImageObserver から継承されたフィールド
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
コンストラクタの概要
Dialog(Dialog owner)
          指定された所有者 Dialog と空のタイトルを持ち、最初は表示されない、モードなし Dialog を構築します。
Dialog(Dialog owner, String title)
          指定された所有者 Dialog とタイトルを持ち、最初は表示されない、モードなし Dialog を構築します。
Dialog(Dialog owner, String title, boolean modal)
          指定された所有者 Dialog、タイトル、およびモーダリティーを持ち、最初は表示されない Dialog を構築します。
Dialog(Dialog owner, String title, boolean modal, GraphicsConfiguration gc)
          指定された所有者 Dialog、タイトル、モーダリティー、および GraphicsConfiguration を持ち、最初は表示されない Dialog を構築します。
Dialog(Frame owner)
          指定された所有者 Frame と空のタイトルを持ち、最初は表示されない、モードなし Dialog を構築します。
Dialog(Frame owner, boolean modal)
          指定された所有者 Frame とモーダリティー、および空のタイトルを持ち、最初は表示されない Dialog を構築します。
Dialog(Frame owner, String title)
          指定された所有者 Frame とタイトルを持ち、最初は表示されない、モードなし Dialog を構築します。
Dialog(Frame owner, String title, boolean modal)
          指定された所有者 Frame、タイトル、およびモーダリティーを持ち、最初は表示されない Dialog を構築します。
Dialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)
          指定された所有者 Frame、タイトル、モーダリティー、および GraphicsConfiguration を持ち、最初は表示されない Dialog を構築します。
Dialog(Window owner)
          指定された所有者 Window と空のタイトルを持ち、最初は表示されない、モードなし Dialog を構築します。
Dialog(Window owner, Dialog.ModalityType modalityType)
          指定された所有者 Window とモーダリティー、および空のタイトルを持ち、最初は表示されない Dialog を構築します。
Dialog(Window owner, String title)
          指定された所有者 Window とタイトルを持ち、最初は表示されない、モードなし Dialog を構築します。
Dialog(Window owner, String title, Dialog.ModalityType modalityType)
          指定された所有者 Window、タイトル、およびモーダリティーを持ち、最初は表示されない Dialog を構築します。
Dialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)
          指定された所有者 Window、タイトル、モーダリティー、および GraphicsConfiguration を持ち、最初は表示されない Dialog を構築します。
 
メソッドの概要
 void addNotify()
          ネイティブスクリーンリソースに接続することにより、この Dialog を表示可能にします。
 AccessibleContext getAccessibleContext()
          このダイアログに関連した AccessibleContext を返します。
 Dialog.ModalityType getModalityType()
          このダイアログのモーダリティータイプを返します。
 String getTitle()
          ダイアログのタイトルを返します。
 void hide()
          推奨されていません。 JDK version 1.5 以降は、 setVisible(boolean) に置き換えられました。
 boolean isModal()
          ダイアログがモーダルであるかどうかを示します。
 boolean isResizable()
          ユーザーがこのダイアログのサイズを変更できるかどうかを示します。
 boolean isUndecorated()
          このダイアログが装飾を持たないことを示します。
protected  String paramString()
          このダイアログの状態を表す文字列を返します。
 void setModal(boolean modal)
          ダイアログがモーダルかどうかを指定します。
 void setModalityType(Dialog.ModalityType type)
          このダイアログのモーダリティータイプを設定します。
 void setResizable(boolean resizable)
          ユーザーがこのダイアログのサイズを変更できるかどうかを設定します。
 void setTitle(String title)
          Dialog のタイトルを設定します。
 void setUndecorated(boolean undecorated)
          このダイアログの装飾の有効化と無効化を切り替えます。
 void setVisible(boolean b)
          パラメータ b の値に応じて、この Dialog を表示するか、または非表示にします。
 void show()
          推奨されていません。 JDK version 1.5 以降は、 setVisible(boolean) に置き換えられました。
 void toBack()
          この Window が可視の場合、この Window を背後に送り、フォーカスされているかまたはアクティブ Window の場合はフォーカスまたはアクティベーションを消失するようにします。
 
クラス java.awt.Window から継承されたメソッド
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOwnedWindows, getOwner, getOwnerlessWindows, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, toFront
 
クラス java.awt.Container から継承されたメソッド
add, add, add, add, add, addContainerListener, addImpl, 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, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, 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, getBaseline, getBaselineResizeBehavior, 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, resize, resize, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusUpCycle
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

DEFAULT_MODALITY_TYPE

public static final Dialog.ModalityType DEFAULT_MODALITY_TYPE
モーダルダイアログのデフォルトのモーダリティータイプ。デフォルトのモーダリティータイプは APPLICATION_MODAL です。古い形式の setModal(true) の呼び出しは、setModalityType(DEFAULT_MODALITY_TYPE) と等価です。

導入されたバージョン:
1.6
関連項目:
Dialog.ModalityType, setModal(boolean)
コンストラクタの詳細

Dialog

public Dialog(Frame owner)
指定された所有者 Frame と空のタイトルを持ち、最初は表示されない、モードなし Dialog を構築します。

パラメータ:
owner - ダイアログの所有者。 ダイアログに所有者がない場合は null
例外:
IllegalArgumentException - 所有者GraphicsConfiguration がスクリーンデバイスによらない場合
HeadlessException - GraphicsEnvironment.isHeadless()true を返す場合
関連項目:
GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Dialog

public Dialog(Frame owner,
              boolean modal)
指定された所有者 Frame とモーダリティー、および空のタイトルを持ち、最初は表示されない Dialog を構築します。

パラメータ:
owner - ダイアログの所有者。 ダイアログに所有者がない場合は null
modal - ダイアログの表示中に、ほかのトップレベルウィンドウに対してユーザー入力を ブロックするかどうかを指定する。false の場合、ダイアログは MODELESStrue の場合、モーダリティータイププロパティーは DEFAULT_MODALITY_TYPE に設定される
例外:
IllegalArgumentException - 所有者GraphicsConfiguration がスクリーンデバイスによらない場合
HeadlessException - GraphicsEnvironment.isHeadless()true を返す場合
関連項目:
Dialog.ModalityType, Dialog.ModalityType.MODELESS, DEFAULT_MODALITY_TYPE, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Frame owner,
              String title)
指定された所有者 Frame とタイトルを持ち、最初は表示されない、モードなし Dialog を構築します。

パラメータ:
owner - ダイアログの所有者。 ダイアログに所有者がない場合は null
title - ダイアログのタイトル。 ダイアログにタイトルがない場合は null
例外:
IllegalArgumentException - 所有者GraphicsConfiguration がスクリーンデバイスによらない場合
HeadlessException - GraphicsEnvironment.isHeadless()true を返す場合
関連項目:
GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Dialog

public Dialog(Frame owner,
              String title,
              boolean modal)
指定された所有者 Frame、タイトル、およびモーダリティーを持ち、最初は表示されない Dialog を構築します。

パラメータ:
owner - ダイアログの所有者。 ダイアログに所有者がない場合は null
title - ダイアログのタイトル。 ダイアログにタイトルがない場合は null
modal - ダイアログの表示中に、ほかのトップレベルウィンドウに対してユーザー入力を ブロックするかどうかを指定する。false の場合、ダイアログは MODELESStrue の場合、モーダリティータイププロパティーは DEFAULT_MODALITY_TYPE に設定される
例外:
IllegalArgumentException - 所有者GraphicsConfiguration がスクリーンデバイスによらない場合
HeadlessException - GraphicsEnvironment.isHeadless()true を返す場合
関連項目:
Dialog.ModalityType, Dialog.ModalityType.MODELESS, DEFAULT_MODALITY_TYPE, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Dialog

public Dialog(Frame owner,
              String title,
              boolean modal,
              GraphicsConfiguration gc)
指定された所有者 Frame、タイトル、モーダリティー、および GraphicsConfiguration を持ち、最初は表示されない Dialog を構築します。

パラメータ:
owner - ダイアログの所有者。 ダイアログに所有者がない場合は null
title - ダイアログのタイトル。 ダイアログにタイトルがない場合は null
modal - ダイアログの表示中に、ほかのトップレベルウィンドウに対してユーザー入力を ブロックするかどうかを指定する。false の場合、ダイアログは MODELESStrue の場合、モーダリティータイププロパティーは DEFAULT_MODALITY_TYPE に設定される
gc - ターゲットスクリーンデバイスの GraphicsConfigurationnull の場合は、システムのデフォルトの GraphicsConfiguration とみなす
例外:
IllegalArgumentException - gc が スクリーンデバイスによらない場合
HeadlessException - GraphicsEnvironment.isHeadless()true を返す場合
導入されたバージョン:
1.4
関連項目:
Dialog.ModalityType, Dialog.ModalityType.MODELESS, DEFAULT_MODALITY_TYPE, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Dialog

public Dialog(Dialog owner)
指定された所有者 Dialog と空のタイトルを持ち、最初は表示されない、モードなし Dialog を構築します。

パラメータ:
owner - ダイアログの所有者。 ダイアログに所有者がない場合は null
例外:
IllegalArgumentException - 所有者GraphicsConfiguration がスクリーンデバイスによらない場合
HeadlessException - GraphicsEnvironment.isHeadless()true を返す場合
導入されたバージョン:
1.2
関連項目:
GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Dialog owner,
              String title)
指定された所有者 Dialog とタイトルを持ち、最初は表示されない、モードなし Dialog を構築します。

パラメータ:
owner - ダイアログの所有者。 ダイアログに所有者がない場合は null
title - ダイアログのタイトル。 ダイアログにタイトルがない場合は null
例外:
IllegalArgumentException - 所有者GraphicsConfiguration がスクリーンデバイスによらない場合
HeadlessException - GraphicsEnvironment.isHeadless()true を返す場合
導入されたバージョン:
1.2
関連項目:
GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Dialog owner,
              String title,
              boolean modal)
指定された所有者 Dialog、タイトル、およびモーダリティーを持ち、最初は表示されない Dialog を構築します。

パラメータ:
owner - ダイアログの所有者。 ダイアログに所有者がない場合は null
title - ダイアログのタイトル。 ダイアログにタイトルがない場合は null
modal - ダイアログの表示中に、ほかのトップレベルウィンドウに対してユーザー入力を ブロックするかどうかを指定する。false の場合、ダイアログは MODELESStrue の場合、モーダリティータイププロパティーは DEFAULT_MODALITY_TYPE に設定される
例外:
IllegalArgumentException - 所有者GraphicsConfiguration がスクリーンデバイスによらない場合
HeadlessException - GraphicsEnvironment.isHeadless()true を返す場合
導入されたバージョン:
1.2
関連項目:
Dialog.ModalityType, Dialog.ModalityType.MODELESS, DEFAULT_MODALITY_TYPE, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Dialog owner,
              String title,
              boolean modal,
              GraphicsConfiguration gc)
指定された所有者 Dialog、タイトル、モーダリティー、および GraphicsConfiguration を持ち、最初は表示されない Dialog を構築します。

パラメータ:
owner - ダイアログの所有者。 ダイアログに所有者がない場合は null
title - ダイアログのタイトル。 ダイアログにタイトルがない場合は null
modal - ダイアログの表示中に、ほかのトップレベルウィンドウに対してユーザー入力を ブロックするかどうかを指定する。false の場合、ダイアログは MODELESStrue の場合、モーダリティータイププロパティーは DEFAULT_MODALITY_TYPE に設定される
gc - ターゲットスクリーンデバイスの GraphicsConfigurationnull の場合は、システムのデフォルトの GraphicsConfiguration とみなす
例外:
IllegalArgumentException - gc が スクリーンデバイスによらない場合
HeadlessException - GraphicsEnvironment.isHeadless()true を返す場合
導入されたバージョン:
1.4
関連項目:
Dialog.ModalityType, Dialog.ModalityType.MODELESS, DEFAULT_MODALITY_TYPE, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Dialog

public Dialog(Window owner)
指定された所有者 Window と空のタイトルを持ち、最初は表示されない、モードなし Dialog を構築します。

パラメータ:
owner - ダイアログの所有者。所有者は、 DialogFrame、またはこれらの下位クラスのいずれかのインスタンス、 あるいは null でなければならない
例外:
IllegalArgumentException - 所有者Dialog または Frame のインスタンスでない場合
IllegalArgumentException - 所有者GraphicsConfiguration がスクリーンデバイスによらない場合
HeadlessException - GraphicsEnvironment.isHeadless()true を返す場合
導入されたバージョン:
1.6
関連項目:
GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Window owner,
              String title)
指定された所有者 Window とタイトルを持ち、最初は表示されない、モードなし Dialog を構築します。

パラメータ:
owner - ダイアログの所有者。所有者は、 DialogFrame、またはこれらの下位クラスのいずれかのインスタンス、 あるいは null でなければならない
title - ダイアログのタイトル。 ダイアログにタイトルがない場合は null
例外:
IllegalArgumentException - 所有者Dialog または Frame のインスタンスでない場合
IllegalArgumentException - 所有者GraphicsConfiguration がスクリーンデバイスによらない場合
HeadlessException - GraphicsEnvironment.isHeadless()true を返す場合
導入されたバージョン:
1.6
関連項目:
GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Window owner,
              Dialog.ModalityType modalityType)
指定された所有者 Window とモーダリティー、および空のタイトルを持ち、最初は表示されない Dialog を構築します。

パラメータ:
owner - ダイアログの所有者。所有者は、 DialogFrame、またはこれらの下位クラスのいずれかのインスタンス、 あるいは null でなければならない
modalityType - ダイアログの表示中に、ほかのウィンドウに対して入力を ブロックするかどうかを指定する。null 値またはサポートされていないモーダリティータイプの場合は、 MODELESS に相当する
例外:
IllegalArgumentException - 所有者Dialog または Frame のインスタンスでない場合
IllegalArgumentException - 所有者GraphicsConfiguration がスクリーンデバイスによらない場合
HeadlessException - GraphicsEnvironment.isHeadless()true を返す場合
SecurityException - 呼び出し側スレッドに、 指定された modalityType でモーダルダイアログを作成するアクセス権がない場合
導入されたバージョン:
1.6
関連項目:
Dialog.ModalityType, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)

Dialog

public Dialog(Window owner,
              String title,
              Dialog.ModalityType modalityType)
指定された所有者 Window、タイトル、およびモーダリティーを持ち、最初は表示されない Dialog を構築します。

パラメータ:
owner - ダイアログの所有者。所有者は、 DialogFrame、またはこれらの下位クラスのいずれかのインスタンス、 あるいは null でなければならない
title - ダイアログのタイトル。 ダイアログにタイトルがない場合は null
modalityType - ダイアログの表示中に、ほかのウィンドウに対して入力を ブロックするかどうかを指定する。null 値またはサポートされていないモーダリティータイプの場合は、 MODELESS に相当する
例外:
IllegalArgumentException - 所有者Dialog または Frame のインスタンスでない場合
IllegalArgumentException - 所有者GraphicsConfiguration がスクリーンデバイスによらない場合
HeadlessException - GraphicsEnvironment.isHeadless()true を返す場合
SecurityException - 呼び出し側スレッドに、 指定された modalityType でモーダルダイアログを作成するアクセス権がない場合
導入されたバージョン:
1.6
関連項目:
Dialog.ModalityType, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)

Dialog

public Dialog(Window owner,
              String title,
              Dialog.ModalityType modalityType,
              GraphicsConfiguration gc)
指定された所有者 Window、タイトル、モーダリティー、および GraphicsConfiguration を持ち、最初は表示されない Dialog を構築します。

パラメータ:
owner - ダイアログの所有者。所有者は、 DialogFrame、またはこれらの下位クラスのいずれかのインスタンス、 あるいは null でなければならない
title - ダイアログのタイトル。 ダイアログにタイトルがない場合は null
modalityType - ダイアログの表示中に、ほかのウィンドウに対して入力を ブロックするかどうかを指定する。null 値またはサポートされていないモーダリティータイプの場合は、 MODELESS に相当する
gc - ターゲットスクリーンデバイスの GraphicsConfigurationnull の場合は、システムのデフォルトの GraphicsConfiguration とみなす
例外:
IllegalArgumentException - 所有者Dialog または Frame のインスタンスでない場合
IllegalArgumentException - gc が スクリーンデバイスによらない場合
HeadlessException - GraphicsEnvironment.isHeadless()true を返す場合
SecurityException - 呼び出し側スレッドに、 指定された modalityType でモーダルダイアログを作成するアクセス権がない場合
導入されたバージョン:
1.6
関連項目:
Dialog.ModalityType, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)
メソッドの詳細

addNotify

public void addNotify()
ネイティブスクリーンリソースに接続することにより、この Dialog を表示可能にします。ダイアログを表示可能にすると、そのダイアログのすべての子も表示可能になります。このメソッドは、ツールキットによって内部で呼び出されます。 プログラムが直接呼び出すことはできません。

オーバーライド:
クラス Window 内の addNotify
関連項目:
Component.isDisplayable(), Window.removeNotify()

isModal

public boolean isModal()
ダイアログがモーダルであるかどうかを示します。  

このメソッドは現在廃止されていて、下位互換のためだけに残されています。代わりに、getModalityType() を使用してください。

戻り値:
このダイアログウィンドウがモーダルの場合は true、 そうでない場合は false
関連項目:
DEFAULT_MODALITY_TYPE, Dialog.ModalityType.MODELESS, setModal(boolean), getModalityType(), setModalityType(java.awt.Dialog.ModalityType)

setModal

public void setModal(boolean modal)
ダイアログがモーダルかどうかを指定します。  

このメソッドは現在廃止されていて、下位互換のためだけに残されています。代わりに、setModalityType() を使用してください。  

注:表示されているダイアログのモーダリティーを変更した場合は、いったん非表示にしてから再度表示するまで、変更が反映されないことがあります。

パラメータ:
modal - ダイアログの表示中に、ほかのウィンドウに対して入力を ブロックするかどうかを指定する。setModal(true) の呼び出しは setModalityType(Dialog.DEFAULT_MODALITY_TYPE) と等価で、 setModal(false) の呼び出しは setModalityType(Dialog.ModalityType.MODELESS) と等価
導入されたバージョン:
1.1
関連項目:
DEFAULT_MODALITY_TYPE, Dialog.ModalityType.MODELESS, isModal(), getModalityType(), setModalityType(java.awt.Dialog.ModalityType)

getModalityType

public Dialog.ModalityType getModalityType()
このダイアログのモーダリティータイプを返します。

戻り値:
このダイアログのモーダリティータイプ
導入されたバージョン:
1.6
関連項目:
setModalityType(java.awt.Dialog.ModalityType)

setModalityType

public void setModalityType(Dialog.ModalityType type)
このダイアログのモーダリティータイプを設定します。使用可能なモーダリティータイプについては、ModalityType を参照してください。  

指定されたモーダリティータイプがサポートされていない場合は、MODELESS が使用されます。このメソッドを呼び出したあとで getModalityType() を呼び出して、モーダリティータイプが設定されたことを確認するとよいでしょう。  

注:表示されているダイアログのモーダリティーを変更した場合は、いったん非表示にしてから再度表示するまで、変更が反映されないことがあります。

パラメータ:
type - ダイアログの表示中に、ほかのウィンドウに対して入力を ブロックするかどうかを指定する。null 値またはサポートされていないモーダリティータイプの場合は、 MODELESS に相当する
例外:
SecurityException - 呼び出し側スレッドに、 指定された modalityType でモーダルダイアログを作成するアクセス権がない場合
導入されたバージョン:
1.6
関連項目:
getModalityType(), Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)

getTitle

public String getTitle()
ダイアログのタイトルを返します。タイトルは、ダイアログのボーダーに表示されます。

戻り値:
このダイアログウィンドウのタイトル。タイトルは null の場合もある
関連項目:
setTitle(java.lang.String)

setTitle

public void setTitle(String title)
Dialog のタイトルを設定します。

パラメータ:
title - ダイアログのボーダーに表示されるタイトル。 null の場合、空のタイトルが表示される
関連項目:
getTitle()

setVisible

public void setVisible(boolean b)
パラメータ b の値に応じて、この Dialog を表示するか、または非表示にします。

オーバーライド:
クラス Window 内の setVisible
パラメータ:
b - true の場合は Dialog を表示し、 そうでない場合は Dialog を非表示にする。 ダイアログまたはその所有者がまだ表示可能でない場合は、 その両方が表示可能になる。 ダイアログは、表示される前に検査される。 false の場合は、Dialog を非表示にし、 setVisible(true) が現在ブロックされている場合は戻るようにする

モーダルダイアログに関する注意.

  • setVisible(true): ダイアログがまだ表示されていない場合、 setVisible(false) または dispose の呼び出しによって ダイアログが非表示になるまで、 この呼び出しは戻りません。
  • setVisible(false): ダイアログを非表示にし、 setVisible(true) が現在ブロックされている場合は戻るようにします。
  • このメソッドがブロックされている間は、 ほかのイベントはブロックされないようにツールキットで保証されるので、 イベントディスパッチスレッドからこのメソッドを呼び出してもかまいません。
関連項目:
Window.setVisible(boolean), Window.dispose(), Component.isDisplayable(), Component.validate(), isModal()

show

@Deprecated
public void show()
推奨されていません。 JDK version 1.5 以降は、 setVisible(boolean) に置き換えられました。

Dialog を表示します。ダイアログまたはその所有者がまだ表示可能でない場合は、その両方が表示可能になります。ダイアログは、表示される前に検査されます。ダイアログがすでに表示されている場合、このメソッドはダイアログを前面に表示します。  

ダイアログがモーダルで、まだ表示されていない場合、hide または dispose の呼び出しによってダイアログが非表示になるまで、この呼び出しは戻りません。イベントをディスパッチするスレッドからモーダルダイアログを表示することができます。ツールキットでは、このメソッドを呼び出したスレッドがブロックされていても別のイベントポンプが実行されるためです。

オーバーライド:
クラス Window 内の show
関連項目:
Component.hide(), Component.isDisplayable(), Component.validate(), isModal(), Window.setVisible(boolean)

hide

@Deprecated
public void hide()
推奨されていません。 JDK version 1.5 以降は、 setVisible(boolean) に置き換えられました。

Dialog を非表示にし、show が現在ブロックされている場合は戻るようにします。

オーバーライド:
クラス Window 内の hide
関連項目:
Window.show(), Window.dispose(), Window.setVisible(boolean)

toBack

public void toBack()
この Window が可視の場合、この Window を背後に送り、フォーカスされているかまたはアクティブ Window の場合はフォーカスまたはアクティベーションを消失するようにします。  

このウィンドウをスタックされる順の最下位に置き、この VM のほかのすべてのウィンドウの背後に表示します。このウィンドウが可視でない場合、処理は何も行われません。一部のプラットフォームでは、ほかのウィンドウに所有されているウィンドウをオーナーの下に表示することはできません。このウィンドウをスタックされる順のできるだけ下位に移動するためにあらゆる試行が行われます。ただし、開発者はこのメソッドがどんな状況でもこのウィンドウをほかのすべてのウィンドウの下に移動させるとみなさないでください。  

ネイティブなウィンドウ処理システムのバリエーションのため、フォーカスされたアクティブなウィンドウに対して行われた変更は保証されません。開発者は、このウィンドウが WINDOW_LOST_FOCUS または WINDOW_DEACTIVATED イベントを受け取るまで、このウィンドウがフォーカスされていないか、またはアクティブなウィンドウではないと決してみなさないでください。最上位のウィンドウがフォーカスされたウィンドウであるプラットフォームでは、このメソッドはほとんどの場合このウィンドウのフォーカスを消失させます。このような場合、この VM の次に上位にあるフォーカス可能なウィンドウがフォーカスを受け取ります。スタックされる順が、通常フォーカスされたウィンドウに影響しないプラットフォームでは、このメソッドは、フォーカスされたアクティブなウィンドウをほとんど変更されないままにします。  

このダイアログがモーダルで、一部のウィンドウをブロックする場合、それらのウィンドウはすべて背面に移動され、ダイアログの下に保持されます。

オーバーライド:
クラス Window 内の toBack
関連項目:
Window.toBack()

isResizable

public boolean isResizable()
ユーザーがこのダイアログのサイズを変更できるかどうかを示します。デフォルトでは、すべてのダイアログが初期状態でサイズ変更可能です。

戻り値:
ユーザーがダイアログのサイズを変更できる場合は true、 そうでない場合は false
関連項目:
setResizable(boolean)

setResizable

public void setResizable(boolean resizable)
ユーザーがこのダイアログのサイズを変更できるかどうかを設定します。

パラメータ:
resizable - ユーザーがダイアログのサイズを変更できる場合は true、 そうでない場合は false
関連項目:
isResizable()

setUndecorated

public void setUndecorated(boolean undecorated)
このダイアログの装飾の有効化と無効化を切り替えます。ダイアログが表示されていないときにだけ呼び出すことができます。

パラメータ:
undecorated - 有効化できるダイアログ装飾が ない場合は true、 ある場合は false
例外:
IllegalComponentStateException - ダイアログが 表示可能な場合
導入されたバージョン:
1.4
関連項目:
isUndecorated(), Component.isDisplayable()

isUndecorated

public boolean isUndecorated()
このダイアログが装飾を持たないことを示します。デフォルトではすべてのダイアログが装飾を持ちます。

戻り値:
このダイアログが装飾を持たない場合は true、 持つ場合は false
導入されたバージョン:
1.4
関連項目:
setUndecorated(boolean)

paramString

protected String paramString()
このダイアログの状態を表す文字列を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

オーバーライド:
クラス Container 内の paramString
戻り値:
このダイアログウィンドウのパラメータ文字列

getAccessibleContext

public AccessibleContext getAccessibleContext()
このダイアログに関連した AccessibleContext を返します。ダイアログの場合、AccessibleContext は AccessibleAWTDialog の形式を取ります。必要に応じて新規の AccessibleAWTDialog インスタンスが生成されます。

定義:
インタフェース Accessible 内の getAccessibleContext
オーバーライド:
クラス Window 内の getAccessibleContext
戻り値:
この Dialog の AccessibleContext として機能する AccessibleAWTDialog
導入されたバージョン:
1.3

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。