JavaTM 2 Platform
Std. Ed. v1.3

java.awt
クラス Dialog

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Dialog
すべての実装インタフェース:
Accessible, ImageObserver, MenuContainer, Serializable
直系の既知のサブクラス:
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 です。

ダイアログを作成するときには、フレームまたはもう 1 つのダイアログをそのオーナとして定義しなければなりません。表示されているダイアログのオーナウィンドウが非表示になった場合や最小化された場合、そのダイアログは自動的にユーザに表示されなくなります。オーナウィンドウがまた開かれると、ダイアログは再びユーザに表示されます。

ダイアログは、モードなし (デフォルト) またはモーダルのどちらかになります。モーダルダイアログの場合、そのダイアログをオーナとして作成されたウィンドウを除き、アプリケーションコンテキストのほかのトップレベルウィンドウへの入力はできなくなります。

ダイアログは、ウィンドウイベントなどへの WindowOpened、WindowClosing、WindowClosed、WindowActivated、および WindowDeactivated を生成できます。

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

内部クラスの概要
protected  class Dialog.AccessibleAWTDialog
          このクラスは Dialog クラス用のユーザ補助機能のサポートを実装しています。
 
クラス java.awt.Window から継承した内部クラス
Window.AccessibleAWTWindow
 
クラス java.awt.Container から継承した内部クラス
Container.AccessibleAWTContainer
 
クラス java.awt.Component から継承した内部クラス
Component.AccessibleAWTComponent
 
クラス 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 owner, String title)
          指定されたオーナフレームおよびタイトルを持ち、最初は表示されず、モーダルではない Dialog を構築します。
Dialog(Dialog owner, String title, boolean modal)
          指定されたオーナダイアログおよびタイトルを持ち、モーダルであるかどうかを指定された、最初は表示されない Dialog を構築します。
Dialog(Frame owner)
          空のタイトルおよび指定されたオーナフレームを持ち、最初は表示されず、モーダルではない Dialog を構築します。
Dialog(Frame owner, boolean modal)
          空のタイトルおよび指定されたオーナフレームを持ち、モーダルであるかどうかを指定された、最初は表示されない Dialog を構築します。
Dialog(Frame owner, String title)
          指定されたオーナフレームおよびタイトルを持ち、最初は表示されず、モーダルではない Dialog を構築します。
Dialog(Frame owner, String title, boolean modal)
          指定されたオーナフレームおよびタイトルを持ち、モーダルであるかどうかを指定された、最初は表示されない Dialog を構築します。
 
メソッドの概要
 void addNotify()
          ネイティブスクリーンリソースに接続することにより、この Dialog を表示可能にします。
 void dispose()
          現在ブロックされている場合は、Dialog を破棄して show() を返します。
 AccessibleContext getAccessibleContext()
          この Dialog に関連した AccessibleContext を返します。
 String getTitle()
          ダイアログのタイトルを返します。
 void hide()
          現在ブロックされている場合は、Dialog を隠して show() を返します。
 boolean isModal()
          ダイアログがモーダルであるかどうかを示します。
 boolean isResizable()
          ユーザがこのダイアログをサイズ変更できるかどうかを示します。
protected  String paramString()
          ダイアログウィンドウの状態を表すパラメータ文字列を返します。
 void setModal(boolean b)
          ダイアログがモーダルであるべきかどうかを指定します。
 void setResizable(boolean resizable)
          ユーザがこのダイアログをサイズ変更できるかどうかを設定します。
 void setTitle(String title)
          Dialog のタイトルを設定します。
 void show()
          Dialog を表示します。
 
クラス java.awt.Window から継承したメソッド
addWindowListener, applyResourceBundle, applyResourceBundle, finalize, getFocusOwner, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getOwnedWindows, getOwner, getToolkit, getWarningString, isShowing, pack, postEvent, processEvent, processWindowEvent, removeWindowListener, setCursor, toBack, toFront
 
クラス java.awt.Container から継承したメソッド
add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setFont, setLayout, update, validate, validateTree
 
クラス java.awt.Component から継承したメソッド
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, isLightweight, isOpaque, 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, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setDropTarget, setEnabled, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, size, toString, transferFocus
 
クラス java.lang.Object から継承したメソッド
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

コンストラクタの詳細

Dialog

public Dialog(Frame owner)
空のタイトルおよび指定されたオーナフレームを持ち、最初は表示されず、モーダルではない Dialog を構築します。
パラメータ:
owner - ダイアログの所有者
例外:
IllegalArgumentException - ownernull の場合
関連項目:
Component.setSize(int, int), Component.setVisible(boolean)

Dialog

public Dialog(Frame owner,
              boolean modal)
空のタイトルおよび指定されたオーナフレームを持ち、モーダルであるかどうかを指定された、最初は表示されない Dialog を構築します。
パラメータ:
owner - ダイアログの所有者
modal - true の場合、ダイアログが表示されたときは、ほかのアプリケーションウィンドウへの入力は不可
例外:
IllegalArgumentException - ownernull の場合

Dialog

public Dialog(Frame owner,
              String title)
指定されたオーナフレームおよびタイトルを持ち、最初は表示されず、モーダルではない Dialog を構築します。
パラメータ:
owner - ダイアログの所有者
title - ダイアログのタイトル。NullPointerException をスローすることなく、null 値が受け取られる
例外:
IllegalArgumentException - ownernull の場合
関連項目:
Component.setSize(int, int), Component.setVisible(boolean)

Dialog

public Dialog(Frame owner,
              String title,
              boolean modal)
指定されたオーナフレームおよびタイトルを持ち、モーダルであるかどうかを指定された、最初は表示されない Dialog を構築します。
パラメータ:
owner - ダイアログの所有者
title - ダイアログのタイトル。NullPointerException をスローすることなく、null 値が受け取られる
modal - true の場合、ダイアログが表示されたときは、ほかのアプリケーションウィンドウへの入力は不可
例外:
IllegalArgumentException - ownernull の場合
関連項目:
Component.setSize(int, int), Component.setVisible(boolean)

Dialog

public Dialog(Dialog owner)
空のタイトルおよび指定されたオーナダイアログを持ち、最初は表示されず、モーダルではない Dialog を構築します。
パラメータ:
owner - ダイアログの所有者
例外:
IllegalArgumentException - ownernull の場合
導入されたバージョン:
1.2

Dialog

public Dialog(Dialog owner,
              String title)
指定されたオーナフレームおよびタイトルを持ち、最初は表示されず、モーダルではない Dialog を構築します。
パラメータ:
owner - ダイアログの所有者
title - ダイアログのタイトル。NullPointerException をスローすることなく、null 値が受け取られる
例外:
IllegalArgumentException - ownernull の場合
導入されたバージョン:
1.2

Dialog

public Dialog(Dialog owner,
              String title,
              boolean modal)
指定されたオーナダイアログおよびタイトルを持ち、モーダルであるかどうかを指定された、最初は表示されない Dialog を構築します。
パラメータ:
owner - ダイアログの所有者
title - ダイアログのタイトル。NullPointerException をスローすることなく、null 値が受け取られる
modal - true の場合、ダイアログが表示されたときは、ほかのアプリケーションウィンドウへの入力は不可
例外:
IllegalArgumentException - ownernull の場合
導入されたバージョン:
1.2
メソッドの詳細

addNotify

public void addNotify()
ネイティブスクリーンリソースに接続することにより、この Dialog を表示可能にします。ダイアログを表示可能にすると、そのダイアログのすべての子も表示可能になります。このメソッドはツールキットによって内部で呼び出されます。プログラムから直接呼び出されることはありません。
オーバーライド:
クラス Window 内の addNotify
関連項目:
Component.isDisplayable(), Container.removeNotify()

isModal

public boolean isModal()
ダイアログがモーダルであるかどうかを示します。モーダル Dialog が表示されると、このダイアログをオーナとして作成されたウィンドウを除き、アプリケーションコンテキストのほかのウィンドウへのユーザ入力はできません。
戻り値:
このダイアログウィンドウがモーダルの場合は true、そうでない場合は false
関連項目:
setModal(boolean)

setModal

public void setModal(boolean b)
ダイアログがモーダルであるべきかどうかを指定します。
導入されたバージョン:
JDK1.1
関連項目:
isModal()

getTitle

public String getTitle()
ダイアログのタイトルを返します。タイトルは、ダイアログのボーダに表示されます。
戻り値:
このダイアログウィンドウのタイトル。タイトルが null の場合もある
関連項目:
setTitle(java.lang.String)

setTitle

public void setTitle(String title)
Dialog のタイトルを設定します。
パラメータ:
title - ダイアログのボーダに表示されるタイトル
関連項目:
getTitle()

show

public void show()
Dialog を表示します。ダイアログまたはそのオーナがまだ表示可能でない場合は、その両方ともが表示可能になります。ダイアログは、表示される前に検査されます。ダイアログがすでに表示されている場合、このメソッドはダイアログを前面に表示します。

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

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

hide

public void hide()
現在ブロックされている場合は、Dialog を隠して show() を返します。
オーバーライド:
クラス Window 内の hide
クラス java.awt.Window からコピーされたタグ:
関連項目:
Window.show(), Window.dispose()

dispose

public void dispose()
現在ブロックされている場合は、Dialog を破棄して show() を返します。
オーバーライド:
クラス Window 内の dispose
クラス java.awt.Window からコピーされたタグ:
関連項目:
Component.isDisplayable(), Window.pack(), Window.show()

isResizable

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

setResizable

public void setResizable(boolean resizable)
ユーザがこのダイアログをサイズ変更できるかどうかを設定します。
パラメータ:
resizable - ユーザがダイアログのサイズを変更できる場合は true、そうでない場合は false
関連項目:
isResizable()

paramString

protected String paramString()
ダイアログウィンドウの状態を表すパラメータ文字列を返します。この文字列はデバッグに使用します。
オーバーライド:
クラス Container 内の paramString
戻り値:
このダイアログウィンドウのパラメータ文字列

getAccessibleContext

public AccessibleContext getAccessibleContext()
この Dialog に関連した AccessibleContext を返します。ダイアログの場合、AccessibleContext は AccessibleAWTDialog の形式を取ります。必要に応じて新しい AccessibleAWTDialog インスタンスを作成します。
オーバーライド:
クラス Window 内の getAccessibleContext
戻り値:
この Dialog の AccessibleContext として機能する AccessibleAWTDialog

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

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.