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」の仕様を参照してください。

ダイアログは、WindowOpened、WindowClosing、WindowClosed、WindowActivated、WindowDeactivated、WindowGainedFocus、およびWindowLostFocusのWindowEventsを生成できます。

導入されたバージョン:

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, Window.Type

クラス 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から継承されたフィールド

accessibleContext, 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	setBackground(Color bgColor) このウィンドウの背景色を設定します。
void	setModal(boolean modal) ダイアログがモーダルかどうかを指定します。
void	setModalityType(Dialog.ModalityType type) このダイアログのモーダリティ・タイプを設定します。
void	setOpacity(float opacity) ウィンドウの不透明性を設定します。
void	setResizable(boolean resizable) ユーザーがこのダイアログのサイズを変更できるかどうかを設定します。
void	setShape(Shape shape) ウィンドウの形状を設定します。
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, 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, processWindowEvent, 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

クラス 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, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, 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, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, 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, 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

クラス 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 - ownerの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の場合、ダイアログはMODELESS。trueの場合、モーダリティ・タイプ・プロパティはDEFAULT_MODALITY_TYPEに設定される

例外:

IllegalArgumentException - ownerの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 - ownerの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の場合、ダイアログはMODELESS。trueの場合、モーダリティ・タイプ・プロパティはDEFAULT_MODALITY_TYPEに設定される

例外:

IllegalArgumentException - ownerの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の場合、ダイアログはMODELESS。trueの場合、モーダリティ・タイプ・プロパティはDEFAULT_MODALITY_TYPEに設定される

gc - ターゲット画面デバイスのGraphicsConfiguration。nullの場合は、デフォルトのシステム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 - ownerのGraphicsConfigurationが画面デバイスのものでない場合

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

導入されたバージョン:

1.2

関連項目:

GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Dialog owner,
              String title)

指定された所有者Dialogとタイトルを使用して、初期状態で可視ではないモードなしDialogを構築します。

パラメータ:

owner - ダイアログの所有者、またはこのダイアログに所有者がいない場合はnull

title - ダイアログのタイトル、またはこのダイアログにタイトルがない場合はnull

例外:

IllegalArgumentException - ownerの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の場合、ダイアログはMODELESS。trueの場合、モーダリティ・タイプ・プロパティはDEFAULT_MODALITY_TYPEに設定される

例外:

IllegalArgumentException - ownerの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の場合、ダイアログはMODELESS。trueの場合、モーダリティ・タイプ・プロパティはDEFAULT_MODALITY_TYPEに設定される

gc - ターゲット画面デバイスのGraphicsConfiguration。nullの場合は、デフォルトのシステム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 - ダイアログの所有者。所有者は、Dialog、Frame、それらのいずれかの下位クラスのインスタンスまたはnullである必要がある

例外:

IllegalArgumentException - ownerがDialogまたはFrameのインスタンスでない場合

IllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合

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

導入されたバージョン:

1.6

関連項目:

GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Window owner,
              String title)

指定された所有者Windowとタイトルを使用して、初期状態で可視ではないモードなしDialogを構築します。

パラメータ:

owner - ダイアログの所有者。所有者は、Dialog、Frame、それらのいずれかの下位クラスのインスタンスまたはnullである必要がある

title - ダイアログのタイトル、またはこのダイアログにタイトルがない場合はnull

例外:

IllegalArgumentException - ownerがDialogまたはFrameのインスタンスでない場合

IllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合

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

導入されたバージョン:

1.6

関連項目:

GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Window owner,
              Dialog.ModalityType modalityType)

指定された所有者Windowとモーダリティ、および空のタイトルを使用して、初期状態で可視ではないDialogを構築します。

パラメータ:

owner - ダイアログの所有者。所有者は、Dialog、Frame、それらのいずれかの下位クラスのインスタンスまたはnullである必要がある

modalityType - ダイアログが表示されているときに、ほかのウィンドウへの入力がブロックされるかどうかを指定する。null値とサポートされないモーダリティ・タイプはMODELESSと同等である

例外:

IllegalArgumentException - ownerがDialogまたはFrameのインスタンスでない場合

IllegalArgumentException - ownerの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 - ダイアログの所有者。所有者は、Dialog、Frame、それらのいずれかの下位クラスのインスタンスまたはnullである必要がある

title - ダイアログのタイトル、またはこのダイアログにタイトルがない場合はnull

modalityType - ダイアログが表示されているときに、ほかのウィンドウへの入力がブロックされるかどうかを指定する。null値とサポートされないモーダリティ・タイプはMODELESSと同等である

例外:

IllegalArgumentException - ownerがDialogまたはFrameのインスタンスでない場合

IllegalArgumentException - ownerの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 - ダイアログの所有者。所有者は、Dialog、Frame、それらのいずれかの下位クラスのインスタンスまたはnullである必要がある

title - ダイアログのタイトル、またはこのダイアログにタイトルがない場合はnull

modalityType - ダイアログが表示されているときに、ほかのウィンドウへの入力がブロックされるかどうかを指定する。null値とサポートされないモーダリティ・タイプはMODELESSと同等である

gc - ターゲット画面デバイスのGraphicsConfiguration。nullの場合は、デフォルトのシステムGraphicsConfigurationと見なされる

例外:

IllegalArgumentException - ownerが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を表示可能にします。ダイアログを表示可能にすると、そのダイアログのすべての子も表示可能になります。このメソッドは、ツールキットによって内部で呼び出され、プログラムから直接呼び出されることはありません。

オーバーライド:

addNotify、クラス: Window

関連項目:

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を表示または非表示にします。

オーバーライド:

setVisible、クラス: Window

パラメータ:

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

オーバーライド:

show、クラス: Window

関連項目:

Component.hide(), Component.isDisplayable(), Component.validate(), isModal(), Window.setVisible(boolean)

hide

@Deprecated
public void hide()

非推奨。JDK version 1.5以降は、setVisible(boolean)に置き換えられています。

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

オーバーライド:

hide、クラス: Window

関連項目:

Window.show(), Window.dispose(), Window.setVisible(boolean)

toBack

public void toBack()

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

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

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

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

オーバーライド:

toBack、クラス: Window

関連項目:

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)

このダイアログの装飾の有効化と無効化を切り替えます。

ダイアログが表示されていないときにだけ呼び出すことができます。このダイアログを装飾するには、ダイアログがデフォルトの形状を持ち不透明であることが必要です。そうでない場合は、IllegalComponentStateExceptionがスローされます。詳細は、Window.setShape(java.awt.Shape)、Window.setOpacity(float)およびWindow.setBackground(java.awt.Color)を参照してください。

パラメータ:

undecorated - 有効化できるダイアログ装飾がない場合はtrue、ある場合はfalse

例外:

IllegalComponentStateException - ダイアログが表示可能な場合

IllegalComponentStateException - undecoratedがfalseで、このダイアログがデフォルトの形状でない場合

IllegalComponentStateException - undecoratedがfalseで、このダイアログの不透明性が1.0fより小さい場合

IllegalComponentStateException - undecoratedがfalseで、このダイアログの背景色のアルファ値が1.0fより小さい場合

導入されたバージョン:

1.4

関連項目:

isUndecorated(), Component.isDisplayable(), Window.getShape(), Window.getOpacity(), Window.getBackground()

isUndecorated

public boolean isUndecorated()

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

戻り値:

ダイアログが装飾を持たない場合はtrue、そうでない場合はfalse。

導入されたバージョン:

1.4

関連項目:

setUndecorated(boolean)

setOpacity

public void setOpacity(float opacity)

ウィンドウの不透明性を設定します。

不透明性の値は[0..1]の範囲にあります。不透明性レベルを0に設定すると、このウィンドウ上のマウス・イベント処理が無効になる可能性があることに注意してください。これは、プラットフォーム依存の動作です。

1.0fより小さい不透明性の値を設定するには、次の条件が満たされる必要があります。

• 基本となるシステムでTRANSLUCENTの半透明性がサポートされている必要がある
• ウィンドウが非装飾に設定されている必要がある(Frame.setUndecorated(boolean)およびsetUndecorated(boolean)を参照してください)
• ウィンドウがフル・スクリーン・モードであってはいけない(GraphicsDevice.setFullScreenWindow(Window)を参照してください)

要求された不透明性の値が1.0fより小さく、かつ上のいずれかの条件が満たされていない場合、ウィンドウの不透明性は変更されず、IllegalComponentStateExceptionがスローされます。

個々のピクセルの半透明性レベルは、その色のアルファ成分(Window.setBackground(Color)を参照してください)や、このウィンドウの現在の形状(Window.setShape(Shape)を参照してください)によっても影響を受ける可能性があります。

オーバーライド:

setOpacity、クラス: Window

パラメータ:

opacity - ウィンドウに設定する不透明性レベル

関連項目:

Window.getOpacity(), Window.setBackground(Color), Window.setShape(Shape), Frame.isUndecorated(), isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)

setShape

public void setShape(Shape shape)

ウィンドウの形状を設定します。

形状を設定すると、ウィンドウの一部が切り離されます。表示およびクリック可能のままになるのは、特定のShapeに属している部分だけです。shape引数がnullである場合、このメソッドはデフォルトの形状を復元し、ほとんどのプラットフォーム上でウィンドウを矩形にします。

null以外の形状を設定するには、次の条件が満たされる必要があります。

• 基本となるシステムでPERPIXEL_TRANSPARENTの半透明性がサポートされている必要がある
• ウィンドウが非装飾に設定されている必要がある(Frame.setUndecorated(boolean)およびsetUndecorated(boolean)を参照してください)
• ウィンドウがフル・スクリーン・モードであってはいけない(GraphicsDevice.setFullScreenWindow(Window)を参照してください)

要求された形状がnullでなく、かつ上のいずれかの条件が満たされていない場合、このウィンドウの形状は変更されず、UnsupportedOperationExceptionまたはIllegalComponentStateExceptionのどちらかがスローされます。

個々のピクセルの半透明性レベルは、その色のアルファ成分(Window.setBackground(Color)を参照してください)や、不透明性の値(Window.setOpacity(float)を参照してください)によっても影響を受ける可能性があります。詳細は、GraphicsDevice.WindowTranslucencyを参照してください。

オーバーライド:

setShape、クラス: Window

パラメータ:

shape - ウィンドウに設定する形状

関連項目:

Window.getShape(), Window.setBackground(Color), Window.setOpacity(float), Frame.isUndecorated(), isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)

setBackground

public void setBackground(Color bgColor)

このウィンドウの背景色を設定します。

ウィンドウ管理システムがPERPIXEL_TRANSLUCENTの半透明性をサポートしている場合は、特定の背景色のアルファ成分がこのウィンドウの動作モードに影響を与える可能性があります。これは、このウィンドウが不透明(アルファが1.0fに等しい)、またはピクセルごとに半透明(アルファが1.0fより小さい)のどちらである必要があるかを示します。特定の背景色がnullである場合、ウィンドウは完全に不透明であると見なされます。

このウィンドウのピクセルごとの透明度モードを有効にするには、次のすべての条件が満たされる必要があります。

• このウィンドウが配置されているグラフィックス・デバイスでPERPIXEL_TRANSLUCENTの半透明性がサポートされている必要がある
• ウィンドウが非装飾に設定されている必要がある(Frame.setUndecorated(boolean)およびsetUndecorated(boolean)を参照してください)
• ウィンドウがフル・スクリーン・モードであってはいけない(GraphicsDevice.setFullScreenWindow(Window)を参照してください)

要求された背景色のアルファ成分が1.0fより小さく、かつ上のいずれかの条件が満たされていない場合、このウィンドウの背景色は変更されず、特定の背景色のアルファ成分がこのウィンドウの動作モード影響を与えることはなく、UnsupportedOperationExceptionまたはIllegalComponentStateExceptionのどちらかがスローされます。

ウィンドウがピクセルごとに半透明である場合、描画サブシステムは個々のピクセルのアルファ値に従います。ピクセルが0に等しいアルファ色成分でペイントされた場合、そのピクセルは視覚的に透明になります。ピクセルのアルファが1.0fに等しい場合、そのピクセルは完全に不透明です。アルファ色成分の中間値によって、ピクセルは半透明になります。このモードでは、ウィンドウのバックグラウンドは、特定の背景色のアルファ値でペイントされます。このメソッドの引数のアルファ値が0に等しい場合、バックグラウンドはまったくペイントされません。

特定のピクセルの半透明性の実際のレベルは、ウィンドウの不透明性(Window.setOpacity(float)を参照してください)や、このウィンドウの現在の形状(Window.setShape(Shape)を参照してください)によっても異なります。

ピクセルを0のアルファ値でペイントすると、このピクセル上のマウス・イベント処理が無効になる可能性があることに注意してください。これは、プラットフォーム依存の動作です。マウス・イベントが特定のピクセルにディスパッチされないようにするには、そのピクセルをウィンドウの形状から除外する必要があります。

ピクセルごとの半透明性モードを有効にすると、ネイティブ・プラット・フォームの要件のために、このウィンドウのグラフィックス構成が変更される可能性があります。

オーバーライド:

setBackground、クラス: Window

パラメータ:

bgColor - このウィンドウの背景色になる色。

関連項目:

Window.getBackground(), Window.isOpaque(), Window.setOpacity(float), Window.setShape(Shape), Frame.isUndecorated(), isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency), GraphicsConfiguration.isTranslucencyCapable()

paramString

protected String paramString()

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

オーバーライド:

paramString、クラス: Container

戻り値:

このダイアログ・ウィンドウのパラメータ文字列

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

定義:

getAccessibleContext、インタフェース: Accessible

オーバーライド:

getAccessibleContext、クラス: Window

戻り値:

このDialogのAccessibleContextとして機能するAccessibleAWTDialog

導入されたバージョン:

1.3