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 의 어느 쪽인지를 호출하는 것으로 다이얼로그를 표시 가능하게 하지 않으면 정확한 인 세트치는 취득할 수 없습니다. 경계 영역은 다이얼로그 전체의 사이즈에 포함되어 있기 (위해)때문에, 다이얼로그의 일부가 불명료하게 됩니다. 이 때문에, 서브 컴퍼넌트를 draw 및 표시하기 위한 영역은, 좌상구석의 위치가 (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, 및 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 와 빈 상태(empty)의 타이틀을 가져, 처음은 표시되지 않는, 모드 없음 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 와 빈 상태(empty)의 타이틀을 가져, 처음은 표시되지 않는, 모드 없음 Dialog 를 구축합니다.
Dialog (Frame  owner, boolean modal)
          지정된 소유자 Frame 와 모다리티, 및 빈 상태(empty)의 타이틀을 가져, 처음은 표시되지 않는 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 와 빈 상태(empty)의 타이틀을 가져, 처음은 표시되지 않는, 모드 없음 Dialog 를 구축합니다.
Dialog (Window  owner, Dialog.ModalityType  modalityType)
          지정된 소유자 Window 와 모다리티, 및 빈 상태(empty)의 타이틀을 가져, 처음은 표시되지 않는 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 와 빈 상태(empty)의 타이틀을 가져, 처음은 표시되지 않는, 모드 없음 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 와 모다리티, 및 빈 상태(empty)의 타이틀을 가져, 처음은 표시되지 않는 Dialog 를 구축합니다.

파라미터:
owner - 다이얼로그의 소유자. 다이얼로그에 소유자가 없는 경우는 null
modal - 다이얼로그의 표시중에, 다른 톱 레벨 윈도우에 대해서 사용자 입력을 블록 할지 어떨지를 지정한다. false 의 경우, 다이얼로그는 MODELESS. true 의 경우, 모다리티타이프프로파티는 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 의 경우, 다이얼로그는 MODELESS. true 의 경우, 모다리티타이프프로파티는 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 의 경우, 다이얼로그는 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 와 빈 상태(empty)의 타이틀을 가져, 처음은 표시되지 않는, 모드 없음 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 의 경우, 다이얼로그는 MODELESS. true 의 경우, 모다리티타이프프로파티는 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 의 경우, 다이얼로그는 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 와 빈 상태(empty)의 타이틀을 가져, 처음은 표시되지 않는, 모드 없음 Dialog 를 구축합니다.

파라미터:
owner - 다이얼로그의 소유자. 소유자는, Dialog ,Frame , 또는 이러한 하위 클래스의 몇개의 인스턴스, 혹은 null 가 아니면 안된다
예외:
IllegalArgumentException - 소유자Dialog 또는 Frame 의 인스턴스가 아닌 경우
IllegalArgumentException - 소유자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 - 소유자Dialog 또는 Frame 의 인스턴스가 아닌 경우
IllegalArgumentException - 소유자GraphicsConfiguration 가 스크린 디바이스에 의하지 않는 경우
HeadlessException - GraphicsEnvironment.isHeadless()true 를 돌려주는 경우
도입된 버젼:
1.6
관련 항목:
GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Window  owner,
              Dialog.ModalityType  modalityType)
지정된 소유자 Window 와 모다리티, 및 빈 상태(empty)의 타이틀을 가져, 처음은 표시되지 않는 Dialog 를 구축합니다.

파라미터:
owner - 다이얼로그의 소유자. 소유자는, Dialog ,Frame , 또는 이러한 하위 클래스의 몇개의 인스턴스, 혹은 null 가 아니면 안되는
modalityType - 다이얼로그의 표시중에, 다른 윈도우에 대해서 입력을 블록 할지 어떨지를 지정한다. null 치 또는 지원되어 있지 않은 모다리티타이프의 경우는, MODELESS 에 상당한다
예외:
IllegalArgumentException - 소유자Dialog 또는 Frame 의 인스턴스가 아닌 경우
IllegalArgumentException - 소유자GraphicsConfiguration 가 스크린 디바이스에 의하지 않는 경우
HeadlessException - GraphicsEnvironment.isHeadless()true 를 돌려주는 경우
SecurityException - 호출측 thread에, 지정된 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 - 소유자Dialog 또는 Frame 의 인스턴스가 아닌 경우
IllegalArgumentException - 소유자GraphicsConfiguration 가 스크린 디바이스에 의하지 않는 경우
HeadlessException - GraphicsEnvironment.isHeadless()true 를 돌려주는 경우
SecurityException - 호출측 thread에, 지정된 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 - 소유자Dialog 또는 Frame 의 인스턴스가 아닌 경우
IllegalArgumentException - gc 가 스크린 디바이스에 의하지 않는 경우
HeadlessException - GraphicsEnvironment.isHeadless()true 를 돌려주는 경우
SecurityException - 호출측 thread에, 지정된 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 를 표시 가능하게 합니다. 다이얼로그를 표시 가능하게 하면(자), 그 다이얼로그의 모든 아이도 표시 가능하게 됩니다. 이 메소드는, 툴 킷에 의해 내부에서 불려 갑니다. 프로그램이 직접 호출할 수 없습니다.

오버라이드(override):
클래스 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 - 호출측 thread에, 지정된 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 의 경우, 빈 상태(empty)의 타이틀이 표시되는
관련 항목:
getTitle()

setVisible

public void setVisible(boolean b)
파라미터 b 의 값에 응해, 이 Dialog 를 표시하는지, 또는 비표시로 합니다.

오버라이드(override):
클래스 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 의 호출에 의해 다이얼로그가 비표시가 될 때까지, 이 호출은 돌아오지 않습니다. 이벤트를 발송 하는 thread로부터 모덜 다이얼로그를 표시할 수가 있습니다. 툴 킷에서는, 이 메소드를 호출한 thread가 블록 되고 있어도 다른 이벤트 펌프가 실행되기 (위해)때문에입니다.

오버라이드(override):
클래스 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 가 현재 블록 되고 있는 경우는 돌아오도록(듯이) 합니다.

오버라이드(override):
클래스 Window 내의 hide
관련 항목:
Window.show() , Window.dispose() , Window.setVisible(boolean)

toBack

public void toBack()
이 Window 가 가시의 경우, 이 Window 를 배후에 보내, 포커스 되고 있든가 또는 액티브 Window 의 경우는 포커스 또는 액티베이션을 소실하도록(듯이) 합니다.  

이 윈도우를 스택 되는 순서의 최하정도에 두어, 이 VM 외의 모든 윈도우의 배후에 표시합니다. 이 윈도우가 가시가 아닌 경우, 처리는 아무것도 행해지지 않습니다. 일부의 플랫폼에서는, 다른 윈도우에 소유되고 있는 윈도우를 오너아래에 표시할 수 없습니다. 이 윈도우를 스택 되는 순서의 가능한 한 하위로 이동하기 위해서(때문에) 모든 시행을 합니다. 다만, 개발자는 이 메소드가 어떤 상황이라도 이 윈도우를 다른 모든 윈도우아래에 이동시키면(자) 간주하지 말아 주세요.  

네이티브인 윈도우 처리 시스템의 변화(variation)이기 때문에, 포커스 된 액티브한 윈도우에 대해서 행해진 변경은 보증되지 않습니다. 개발자는, 이 윈도우가 WINDOW_LOST_FOCUS 또는 WINDOW_DEACTIVATED 이벤트를 받을 때까지, 이 윈도우가 포커스되어 있지 않은지, 또는 액티브한 윈도우는 아니면 결코 간주하지 말아 주세요. 최상정도의 윈도우가 포커스 된 윈도우인 플랫폼에서는, 이 메소드는대부분의 경우이 윈도우의 포커스를 소실시킵니다. 이러한 경우, 이 VM 의 다음에 상위에 있는 포커스 가능한 윈도우가 포커스를 받습니다. 스택 되는 순서가, 일반적으로 포커스 된 윈도우에 영향을 주지 않는 플랫폼에서는, 이 메소드는, 포커스 된 액티브한 윈도우를거의변경되지 않은 채로 합니다.  

이 다이얼로그가 모덜로, 일부의 윈도우를 블록 하는 경우, 그러한 윈도우는 모두 배면에 이동되어 다이얼로그아래에 보관 유지됩니다.

오버라이드(override):
클래스 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()
이 다이얼로그 상태를 나타내는 캐릭터 라인을 돌려줍니다. 이 메소드는 디버그 전용이며, 반환되는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 반환되는 캐릭터 라인은 빈 상태(empty)의 경우가 있습니다만,null 로는 되지 않습니다.

오버라이드(override):
클래스 Container 내의 paramString
반환값:
이 다이얼로그 윈도우의 파라미터 캐릭터 라인

getAccessibleContext

public AccessibleContext  getAccessibleContext()
이 다이얼로그에 관련한 AccessibleContext 를 돌려줍니다. 다이얼로그의 경우, AccessibleContext 는 AccessibleAWTDialog 의 형식을 취합니다. 필요에 따라서 신규의 AccessibleAWTDialog 인스턴스가 생성됩니다.

정의:
인터페이스 Accessible 내의 getAccessibleContext
오버라이드(override):
클래스 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 도 참조해 주세요.