public class Dialog extends Window
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を生成できます。
WindowEvent, Window.addWindowListener(java.awt.event.WindowListener), 直列化された形式| 修飾子と型 | クラス | 説明 |
|---|---|---|
protected class |
Dialog.AccessibleAWTDialog |
このクラスは
Dialogクラスのアクセシビリティ・サポートを実装しています。 |
static class |
Dialog.ModalExclusionType |
どのトップレベル・ウィンドウも、モーダル・ダイアログによってブロックされないようにマークすることができます。
|
static class |
Dialog.ModalityType |
モーダル・ダイアログは、一部のトップレベル・ウィンドウに対してすべての入力をブロックします。
|
Window.AccessibleAWTWindow, Window.TypeContainer.AccessibleAWTContainerComponent.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy| 修飾子と型 | フィールド | 説明 |
|---|---|---|
static Dialog.ModalityType |
DEFAULT_MODALITY_TYPE |
モーダル・ダイアログのデフォルトのモーダリティ・タイプ。
|
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTABORT, 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の場合はフォーカスまたはアクティベーションを消失するようにします。
|
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, toFrontadd, 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, validateTreeaction, 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, transferFocusUpCyclepublic static final Dialog.ModalityType DEFAULT_MODALITY_TYPE
APPLICATION_MODALです。 古い形式のsetModal(true)の呼出しは、setModalityType(DEFAULT_MODALITY_TYPE)と等価です。 Dialog.ModalityType, setModal(boolean)public Dialog(Frame owner)
Frameと空のタイトルを使用して、初期状態で可視ではないモードなしDialogを構築します。owner - ダイアログの所有者、またはこのダイアログに所有者がいない場合はnullIllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)public Dialog(Frame owner, boolean modal)
Frameとモーダリティ、および空のタイトルを使用して、初期状態で可視ではないDialogを構築します。owner - ダイアログの所有者、またはこのダイアログに所有者がいない場合はnullmodal - ダイアログが表示されているとき、ほかのトップ・レベルのウィンドウへのユーザー入力をブロックするかどうかを指定する。 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()public Dialog(Frame owner, String title)
Frameとタイトルを使用して、初期状態で可視ではないモードなしDialogを構築します。owner - ダイアログの所有者、またはこのダイアログに所有者がいない場合はnulltitle - ダイアログのタイトル、またはこのダイアログにタイトルがない場合はnullIllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)public Dialog(Frame owner, String title, boolean modal)
Frame、タイトル、およびモーダリティを使用して、初期状態で可視ではないDialogを構築します。owner - ダイアログの所有者、またはこのダイアログに所有者がいない場合はnulltitle - ダイアログのタイトル、またはこのダイアログにタイトルがない場合はnullmodal - ダイアログが表示されているとき、ほかのトップ・レベルのウィンドウへのユーザー入力をブロックするかどうかを指定する。 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)public Dialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)
Frame、タイトル、モーダリティ、およびGraphicsConfigurationを使用して、初期状態で可視ではないDialogを構築します。owner - ダイアログの所有者、またはこのダイアログに所有者がいない場合はnulltitle - ダイアログのタイトル、またはこのダイアログにタイトルがない場合はnullmodal - ダイアログが表示されているとき、ほかのトップ・レベルのウィンドウへのユーザー入力をブロックするかどうかを指定する。 falseの場合、ダイアログはMODELESS。trueの場合、モーダリティ・タイプ・プロパティはDEFAULT_MODALITY_TYPEに設定される gc - ターゲット画面デバイスのGraphicsConfiguration。nullの場合は、デフォルトのシステムGraphicsConfigurationと見なされるIllegalArgumentException - gcが画面デバイスのものでない場合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)public Dialog(Dialog owner)
Dialogと空のタイトルを使用して、初期状態で可視ではないモードなしDialogを構築します。owner - ダイアログの所有者、またはこのダイアログに所有者がいない場合はnullIllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合GraphicsEnvironment.isHeadless()public Dialog(Dialog owner, String title)
Dialogとタイトルを使用して、初期状態で可視ではないモードなしDialogを構築します。owner - ダイアログの所有者、またはこのダイアログに所有者がいない場合はnulltitle - ダイアログのタイトル、またはこのダイアログにタイトルがない場合はnullIllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合GraphicsEnvironment.isHeadless()public Dialog(Dialog owner, String title, boolean modal)
Dialog、タイトル、およびモーダリティを使用して、初期状態で可視ではないDialogを構築します。owner - ダイアログの所有者、またはこのダイアログに所有者がいない場合はnulltitle - ダイアログのタイトル、またはこのダイアログにタイトルがない場合はnullmodal - ダイアログが表示されているとき、ほかのトップ・レベルのウィンドウへのユーザー入力をブロックするかどうかを指定する。 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()public Dialog(Dialog owner, String title, boolean modal, GraphicsConfiguration gc)
Dialog、タイトル、モーダリティ、およびGraphicsConfigurationを使用して、初期状態で可視ではないDialogを構築します。owner - ダイアログの所有者、またはこのダイアログに所有者がいない場合はnulltitle - ダイアログのタイトル、またはこのダイアログにタイトルがない場合はnullmodal - ダイアログが表示されているとき、ほかのトップ・レベルのウィンドウへのユーザー入力をブロックするかどうかを指定する。 falseの場合、ダイアログはMODELESS。trueの場合、モーダリティ・タイプ・プロパティはDEFAULT_MODALITY_TYPEに設定される gc - ターゲット画面デバイスのGraphicsConfiguration。nullの場合は、デフォルトのシステムGraphicsConfigurationと見なされるIllegalArgumentException - gcが画面デバイスのものでない場合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)public Dialog(Window owner)
Windowと空のタイトルを使用して、初期状態で可視ではないモードなしDialogを構築します。owner - ダイアログの所有者。 所有者は、Dialog、Frame、それらのいずれかの下位クラスのインスタンスまたはnullである必要がある IllegalArgumentException - ownerがDialogまたはFrameのインスタンスでない場合IllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合GraphicsEnvironment.isHeadless()public Dialog(Window owner, String title)
Windowとタイトルを使用して、初期状態で可視ではないモードなしDialogを構築します。owner - ダイアログの所有者。 所有者は、Dialog、Frame、それらのいずれかの下位クラスのインスタンスまたはnullである必要がある title - ダイアログのタイトル、またはこのダイアログにタイトルがない場合はnullIllegalArgumentException - ownerがDialogまたはFrameのインスタンスでない場合IllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合GraphicsEnvironment.isHeadless()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が指定されたモーダル・ダイアログを作成するためのアクセス権がない場合Dialog.ModalityType, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)public Dialog(Window owner, String title, Dialog.ModalityType modalityType)
Window、タイトル、およびモーダリティを使用して、初期状態で可視ではないDialogを構築します。owner - ダイアログの所有者。 所有者は、Dialog、Frame、それらのいずれかの下位クラスのインスタンスまたはnullである必要がある title - ダイアログのタイトル、またはこのダイアログにタイトルがない場合はnullmodalityType - ダイアログが表示されているときに、ほかのウィンドウへの入力がブロックされるかどうかを指定する。null値とサポートされないモーダリティ・タイプはMODELESSと同等であるIllegalArgumentException - ownerがDialogまたはFrameのインスタンスでない場合IllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない場合HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合SecurityException - 呼出し元スレッドに、modalityTypeが指定されたモーダル・ダイアログを作成するためのアクセス権がない場合Dialog.ModalityType, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)public Dialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)
Window、タイトル、モーダリティ、およびGraphicsConfigurationを使用して、初期状態で可視ではないDialogを構築します。owner - ダイアログの所有者。 所有者は、Dialog、Frame、それらのいずれかの下位クラスのインスタンスまたはnullである必要がある title - ダイアログのタイトル、またはこのダイアログにタイトルがない場合はnullmodalityType - ダイアログが表示されているときに、ほかのウィンドウへの入力がブロックされるかどうかを指定する。null値とサポートされないモーダリティ・タイプはMODELESSと同等であるgc - ターゲット画面デバイスのGraphicsConfiguration。nullの場合は、デフォルトのシステムGraphicsConfigurationと見なされるIllegalArgumentException - ownerがDialogまたはFrameのインスタンスでない場合IllegalArgumentException - gcが画面デバイスのものでない場合HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合SecurityException - 呼出し元スレッドに、modalityTypeが指定されたモーダル・ダイアログを作成するためのアクセス権がない場合Dialog.ModalityType, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)public void addNotify()
addNotify、クラスWindowComponent.isDisplayable(), Window.removeNotify()public boolean isModal()
このメソッドは現在廃止されていて、下位互換のためだけに残されています。 代わりにgetModalityType()を使用します。
true、そうでない場合はfalseDEFAULT_MODALITY_TYPE, Dialog.ModalityType.MODELESS, setModal(boolean), getModalityType(), setModalityType(java.awt.Dialog.ModalityType)public void setModal(boolean modal)
このメソッドは現在廃止されていて、下位互換のためだけに残されています。 代わりにsetModalityType()を使用します。
ノート: 表示されているダイアログのモーダリティを変更した場合は、いったん非表示にしてから再度表示するまで、変更が反映されないことがあります。
modal - ダイアログの表示中に、ほかのウィンドウに対して入力をブロックするかどうかを指定する。setModal(true)の呼出しはsetModalityType(Dialog.DEFAULT_MODALITY_TYPE)と等価で、setModal(false)の呼出しはsetModalityType(Dialog.ModalityType.MODELESS)と等価DEFAULT_MODALITY_TYPE, Dialog.ModalityType.MODELESS, isModal(), getModalityType(), setModalityType(java.awt.Dialog.ModalityType)public Dialog.ModalityType getModalityType()
setModalityType(java.awt.Dialog.ModalityType)public void setModalityType(Dialog.ModalityType type)
ModalityTypeを参照してください。
指定されたモーダリティ・タイプがサポートされていない場合は、MODELESSが使用されます。 このメソッドを呼び出したあとでgetModalityType()を呼び出して、モーダリティ・タイプが設定されたことを確認するとよいでしょう。
ノート: 表示されているダイアログのモーダリティを変更した場合は、いったん非表示にしてから再度表示するまで、変更が反映されないことがあります。
type - ダイアログが表示されているときに、ほかのウィンドウへの入力がブロックされるかどうかを指定する。null値とサポートされないモーダリティ・タイプはMODELESSと同等であるSecurityException - 呼出し元スレッドに、modalityTypeが指定されたモーダル・ダイアログを作成するためのアクセス権がない場合getModalityType(), Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)public String getTitle()
nullも可。 setTitle(java.lang.String)public void setTitle(String title)
title - ダイアログのボーダーに表示されるタイトル。nullの場合、空のタイトルが表示されるgetTitle()public void setVisible(boolean b)
bの値に応じて、このDialogを表示または非表示にします。setVisible、クラスWindowb - 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()@Deprecated public void show()
setVisible(boolean)に置き換えられています。 Dialogを可視にします。 ダイアログまたはその所有者がまだ表示可能でない場合は、その両方が表示可能になります。 ダイアログは、表示される前に検査されます。 ダイアログがすでに表示されている場合、このメソッドはダイアログを前面に表示します。
ダイアログがモーダルで、まだ表示されていない場合、hideまたはdisposeの呼出しによってダイアログが非表示になるまで、この呼出しは戻りません。 イベント・ディスパッチ・スレッドからモーダル・ダイアログを表示することができます。ツールキットでは、このメソッドを呼び出したスレッドがブロックされていても別のイベント・ポンプが実行されるためです。
show、クラスWindowComponent.hide(), Component.isDisplayable(), Component.validate(), isModal(), Window.setVisible(boolean)@Deprecated public void hide()
setVisible(boolean)に置き換えられています。 showが現在ブロックされている場合は戻るようにします。hide、クラスWindowWindow.show(), Window.dispose(), Window.setVisible(boolean)public void toBack()
このウィンドウをスタックされる順の最下位に置き、このVMのほかのすべてのウィンドウの背後に表示します。 このウィンドウが可視でない場合、処理は何も行われません。 一部のプラットフォームでは、ほかのウィンドウに所有されているウィンドウを所有者の下に表示することはできません。 このウィンドウをスタックされる順のできるだけ下位に移動するためにあらゆる試行が行われます。ただし、開発者はこのメソッドがどんな状況でもこのウィンドウがほかのすべてのウィンドウの下に移動するとみなさないでください。
ネイティブなウィンドウ管理システムのバリエーションのため、フォーカスされたアクティブなウィンドウに対して行われた変更は保証されません。 開発者は、このウィンドウがWINDOW_LOST_FOCUSまたはWINDOW_DEACTIVATEDイベントを受け取るまで、このウィンドウがフォーカスされていないか、またはアクティブなウィンドウではないと決してみなさないでください。 最上位のウィンドウがフォーカスされたウィンドウであるプラットフォームでは、このメソッドによりおそらく、このウィンドウはフォーカスを失います。 このような場合、このVMの次に上位にあるフォーカス可能なウィンドウがフォーカスを受け取ります。 スタックされる順が通常、フォーカスされたウィンドウに影響を与えないプラットフォームでは、このメソッドはおそらく、フォーカスされたアクティブなウィンドウを変更されないままにします。
このダイアログがモーダルで、一部のウィンドウをブロックする場合、それらのウィンドウはすべて背面に移動され、ダイアログの下に保持されます。
toBack、クラスWindowWindow.toBack()public boolean isResizable()
true、そうでない場合はfalse。setResizable(boolean)public void setResizable(boolean resizable)
resizable - ユーザーがダイアログのサイズを変更できる場合はtrue、そうでない場合はfalse。isResizable()public void setUndecorated(boolean undecorated)
ダイアログが表示されていないときにだけ呼び出すことができます。 このダイアログを装飾するには、ダイアログがデフォルトの形状を持ち不透明であることが必要です。そうでない場合は、IllegalComponentStateExceptionがスローされます。 詳細は、Window.setShape(java.awt.Shape)、Window.setOpacity(float)およびWindow.setBackground(java.awt.Color)を参照してください。
undecorated - 有効化できるダイアログ装飾がない場合はtrue、ある場合はfalseIllegalComponentStateException - ダイアログが表示可能な場合IllegalComponentStateException - undecoratedがfalseで、このダイアログがデフォルトの形状でない場合IllegalComponentStateException - undecoratedがfalseで、このダイアログの不透明性が1.0fより小さい場合IllegalComponentStateException - undecoratedがfalseで、このダイアログの背景色のアルファ値が1.0fより小さい場合isUndecorated(), Component.isDisplayable(), Window.getShape(), Window.getOpacity(), Window.getBackground()public boolean isUndecorated()
true、そうでない場合はfalse。setUndecorated(boolean)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、クラスWindowopacity - ウィンドウに設定する不透明性レベルWindow.getOpacity(), Window.setBackground(Color), Window.setShape(Shape), Frame.isUndecorated(), isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)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、クラスWindowshape - ウィンドウに設定する形状Window.getShape(), Window.setBackground(Color), Window.setOpacity(float), Frame.isUndecorated(), isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)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、クラスWindowbgColor - このウィンドウの背景色になる色。Window.getBackground(), Window.isOpaque(), Window.setOpacity(float), Window.setShape(Shape), Frame.isUndecorated(), isUndecorated(), GraphicsDevice.WindowTranslucency, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency), GraphicsConfiguration.isTranslucencyCapable()protected String paramString()
nullにはなりません。 paramString、クラスContainerpublic AccessibleContext getAccessibleContext()
getAccessibleContext、インタフェースAccessiblegetAccessibleContext、クラスWindow バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。