javax.swing
인터페이스 RootPaneContainer

알려진 구현 클래스 목록:

JApplet, JDialog, JFrame, JInternalFrame, JWindow

public interface RootPaneContainer

이 인터페이스는 JRootPane 자식을 1개 가지는 JDialog, JFrame, JWindow, JApplet, JInternalFrame 등의 컴퍼넌트에 의해 구현됩니다. 이 인터페이스의 메서드는 JRootPane 프로퍼티의 「대신 」을 할 뿐입니다. 예를 들어, getContentPane()는 일반적으로 다음과 같이 구현됩니다.

 public Container getContentPane() { return getRootPane(). getContentPane();
 } 

이 인터페이스는 단일의 JRootPane를 가지는 JFrame 등의 컴퍼넌트를 특별히 처리하는 Swing GUI 빌더 의 「마커」로서 기능합니다. 예를 들어 GUI 빌더에 서는 RootPaneContainer에 컴퍼넌트를 드롭 하면, frame.getContentPane(). add(child)로 서 해석됩니다.

편의상, JFrame, JDialog, JWindow, JApplet 및 JInternalFrame는 디폴트로 add, remove 및 setLayout 메서드의 모든 호출을 contentPane에 전송 합니다. 즉, 다음과 같이 호출할 수 있습니다.

rootPaneContainer.add(component);

다음과 같이 기술할 필요는 없습니다.

rootPaneContainer.getContentPane(). add(component);

JFrame, JDialog, JWindow, JApplet 및 JInternalFrame에 대한 add 및 setLayout 메서드의 동작은, rootPaneCheckingEnabled 프로퍼티에 의해 제어됩니다. 이 프로퍼티가 true (디폴트)의 경우는 이러한 메서드의 호출이 contentPane에 전송 됩니다. false인 경우, 이러한 메서드는 RootPaneContainer로 직접 실행됩니다. 이 프로퍼티는 서브 클래스만을 대상으로 하고 있기 때문에 보호되고 있습니다.

관련 항목:

JRootPane, JFrame, JDialog, JWindow, JApplet, JInternalFrame

메서드 개요

Container	getContentPane () contentPane를 리턴합니다.
Component	getGlassPane () glassPane를 리턴합니다.
JLayeredPane	getLayeredPane () layeredPane를 리턴합니다.
JRootPane	getRootPane () 이 컴퍼넌트의 단일의 JRootPane 자식을 리턴합니다.
void	setContentPane (Container contentPane) 「contentPane」는 어플리케이션 고유의 컴퍼넌트의 일차 컨테이너입니다.
void	setGlassPane (Component glassPane) glassPane는 항상 rootPane 최초의자식 로 rootPane 레이아웃 매니저에의해 항상 rootPane와 같은 크기인 것이 보증됩니다.
void	setLayeredPane (JLayeredPane layeredPane) contentPane를 관리하는 컨테이너로 경우에 따라서는 도구모음도 관리합니다.

메서드의 상세

getRootPane

JRootPane  getRootPane()

이 컴퍼넌트의 단일의 JRootPane 자식을 리턴합니다. 이 인터페이스의 보통 의 구현에서는 다른 메서드는 모두 인터페이스 전체로 간접적으로 됩니다. rootPane 에는 glassPane와 layeredPane 2 살의 자식이 있습니다.

반환값:

이 컴퍼넌트의 단일의 JRootPane 자식

관련 항목:

JRootPane

setContentPane

void setContentPane(Container  contentPane)

「contentPane」는 어플리케이션 고유의 컴퍼넌트의 일차 컨테이너입니다. 어플리케이션에서는 contentPane에 자식을 추가하거나 그 레이아웃 매니저를 설정하거나 합니다.

contentPane를 null 로 할 수 없습니다.

일반적으로 다음과 같이 구현됩니다. getRootPane(). setContentPane(contentPane);

파라미터:

contentPane - 이 JRootPane 컨텐츠의 컨테이너

예외:

IllegalComponentStateException - 컨텐츠 구획 파라미터가 null인 경우 (실행시 예외)

관련 항목:

JRootPane.getContentPane(), getContentPane()

getContentPane

Container  getContentPane()

contentPane를 리턴합니다.

반환값:

contentPane 프로퍼티의 값

관련 항목:

setContentPane(java.awt.Container)

setLayeredPane

void setLayeredPane(JLayeredPane  layeredPane)

contentPane를 관리하는 컨테이너로 경우에 따라서는 도구모음도 관리합니다. layeredPane를 이용할 수 있는 것은 관리하고 있는 레이아웃이 아닌 RootPaneContainer에 자식을 추가하는 하위 객체입니다. 예를 들어 내부 다이얼로그나 드래그＆드롭 효과를 가지는 컴퍼넌트 등입니다.

layeredPane를 null 로 할 수 없습니다.

일반적으로 다음과 같이 구현됩니다.

  getRootPane(). setLayeredPane(layeredPane);

예외:

IllegalComponentStateException - 계층화 구획 파라미터가 null인 경우 (실행시 예외)

관련 항목:

getLayeredPane(), JRootPane.getLayeredPane()

getLayeredPane

JLayeredPane  getLayeredPane()

layeredPane를 리턴합니다.

반환값:

layeredPane 프로퍼티의 값

관련 항목:

setLayeredPane(javax.swing.JLayeredPane)

setGlassPane

void setGlassPane(Component  glassPane)

glassPane는 항상 rootPane 최초의자식 로 rootPane 레이아웃 매니저에의해 항상 rootPane와 같은 크기인 것이 보증됩니다. 또, 디폴트에서는 투과로 가시가 아닙니다. glassPane를 사용하면, 리스너를 추가해 glassPane를 가시로 설정하는 것으로 모든 키보드 및 마우스 입력을 일시적으로 글로브 할 수 있습니다. 디폴트에서는 glassPane는 가시가 아닙니다.

glassPane를 null 로 설정할 수 없습니다.

일반적으로 다음과 같이 구현됩니다. getRootPane(). setGlassPane(glassPane);

관련 항목:

getGlassPane(), JRootPane.setGlassPane(java.awt.Component)

getGlassPane

Component  getGlassPane()

glassPane를 리턴합니다.

반환값:

glassPane 프로퍼티의 값

관련 항목:

setGlassPane(java.awt.Component)