JDialog — 대화상자 최상위 창 클래스

JDialog — 대화상자 최상위 창 클래스

JDialog는 대화상자 창을 만들기 위한 주요 클래스입니다. 사용자 정의 대화상자를 만들거나 JOptionPane의 다양한 표준 대화상자를 사용할 수 있습니다.

출처: Java API Reference

본문

public class JDialog extends Dialog implements WindowConstants, Accessible, RootPaneContainer

대화상자 창을 만들기 위한 주요 클래스입니다. 이 클래스로 사용자 정의 대화상자를 만들거나 JOptionPane의 많은 클래스 메서드를 호출해 다양한 표준 대화상자를 만들 수 있습니다. 대화상자 만들기에 대한 정보는 The Java Tutorial의 "How to Make Dialogs" 섹션을 참고하세요. JDialog 컴포넌트는 유일한 자식으로 JRootPane을 포함합니다. contentPane이 JDialog 자식들의 부모가 되어야 합니다. 편의를 위해 add, remove, setLayout 메서드가 재정의되어 ContentPane의 해당 메서드로 호출을 위임합니다. 예를 들어 대화상자에 자식 컴포넌트를 추가할 수 있습니다. dialog.add(child); 그러면 child가 contentPane에 추가됩니다. contentPane은 항상 null이 아니며, null로 설정하려 하면 예외가 발생합니다. 기본 contentPane에는 BorderLayout 매니저가 설정됩니다. JDialog의 LayoutManager 추가·제거·설정에 대한 자세한 내용은 RootPaneContainer를 참고하세요. contentPane, glassPane, layeredPane 컴포넌트의 전체 설명은 JRootPane 문서를 참고하세요. 다중 화면 환경에서는 소유자와 다른 화면 장치에 JDialog를 만들 수 있습니다. 경고: Swing은 스레드에 안전하지 않습니다. 이 클래스의 직렬화된 객체는 향후 Swing 버전과 호환되지 않을 수 있습니다. 현재 직렬화 지원은 단기 저장이나 같은 버전의 Swing을 실행하는 애플리케이션 간 RMI에 적합합니다. 1.4부터 모든 JavaBean의 장기 저장 지원이 java.beans 패키지에 추가되었으니 XMLEncoder를 참고하세요.

rootPane

protected JRootPane rootPane

contentPane을 관리하는 JRootPane 인스턴스입니다.

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

true이면 add와 setLayout 호출이 contentPane으로 전달됩니다.

JDialog

public JDialog()

제목이 없는 모달이 아닌 Dialog로 JDialog를 만듭니다.

JDialog

public JDialog(Dialog owner)

지정된 Dialog가 소유하는 제목 없는 모달이 아닌 Dialog를 만듭니다.

  • 매개변수: owner - 이 대화상자를 소유하는 Dialog

JDialog

public JDialog(Frame owner)

지정된 Frame이 소유하는 제목 없는 모달이 아닌 Dialog를 만듭니다.

  • 매개변수: owner - 이 대화상자를 소유하는 Frame

JDialog

public JDialog(Frame owner, boolean modal)

지정된 Frame이 소유하는 제목 없는 Dialog를 만듭니다.

  • 매개변수: owner - 이 대화상자를 소유하는 Frame
  • 매개변수: modal - 대화상자를 모달로 만들려면 true

JDialog

public JDialog(Frame owner, String title)

지정된 Frame이 소유하고 지정된 제목을 가진 모달이 아닌 Dialog를 만듭니다.

  • 매개변수: owner - 이 대화상자를 소유하는 Frame
  • 매개변수: title - 대화상자의 제목

JDialog

public JDialog(Frame owner, String title, boolean modal)

지정된 Frame이 소유하고 지정된 제목을 가진 Dialog를 만듭니다.

  • 매개변수: owner - 이 대화상자를 소유하는 Frame
  • 매개변수: title - 대화상자의 제목
  • 매개변수: modal - 대화상자를 모달로 만들려면 true

getContentPane

public Container getContentPane()

이 대화상자의 contentPane 객체를 반환합니다.

  • 반환값: contentPane 프로퍼티 값

setContentPane

public void setContentPane(Container contentPane)

contentPane 프로퍼티를 설정합니다.

  • 매개변수: contentPane - 이 대화상자의 contentPane 객체
  • 예외: IllegalComponentStateException - content pane 매개변수가 null인 경우

setJMenuBar

public void setJMenuBar(JMenuBar menu)

이 대화상자의 메뉴바를 설정합니다.

  • 매개변수: menu - 대화상자에 놓을 메뉴바

getJMenuBar

public JMenuBar getJMenuBar()

이 대화상자에 설정된 메뉴바를 반환합니다.

  • 반환값: 이 대화상자에 설정된 메뉴바

setDefaultCloseOperation

public void setDefaultCloseOperation(int operation)

사용자가 대화상자에서 "닫기"를 클릭할 때 어떤 일이 벌어질지 설정합니다.

  • 매개변수: operation - WindowConstants.DO_NOTHING_ON_CLOSE, HIDE_ON_CLOSE, DISPOSE_ON_CLOSE 중 하나

getRootPane

public JRootPane getRootPane()

이 대화상자의 rootPane 객체를 반환합니다.

  • 반환값: 이 컴포넌트의 JRootPane 자식

setLayout

public void setLayout(LayoutManager manager)

LayoutManager를 설정합니다. 호출을 contentPane으로 조건부로 전달하도록 재정의되었습니다.

  • 매개변수: manager - LayoutManager

더 알아보기