JApplet — 스윙 애플릿 클래스

JApplet — 스윙 애플릿 클래스

JApplet은 JFC/Swing 컴포넌트 구조를 지원하도록 확장된 java.applet.Applet입니다. 콘텐츠 창·레이어드 창·유리 창 구조를 제공합니다.

출처: Java API Reference

본문

@Deprecated(since="9", forRemoval=true) public class JApplet extends Applet implements Accessible, RootPaneContainer

JFC/Swing 컴포넌트 구조를 지원하도록 확장된 java.applet.Applet의 확장 버전입니다. JApplet은 java.applet.Applet과 약간 호환되지 않습니다. JApplet은 유일한 자식으로 JRootPane을 포함합니다. contentPane이 JApplet 자식들의 부모가 되어야 합니다. 편의를 위해 add, remove, setLayout 메서드가 재정의되어 ContentPane의 해당 메서드로 호출을 위임합니다. 예를 들어 애플릿에 자식 컴포넌트를 다음과 같이 추가할 수 있습니다. applet.add(child); 그러면 child가 contentPane에 추가됩니다. contentPane은 항상 null이 아니며, null로 설정하려 하면 JApplet이 예외를 발생시킵니다. 기본 contentPane에는 BorderLayout 매니저가 설정됩니다. JApplet에 대한 LayoutManager 추가·제거·설정에 대한 자세한 내용은 RootPaneContainer를 참고하세요. contentPane, glassPane, layeredPane 프로퍼티의 전체 설명은 JRootPane 문서를 참고하세요. 경고: Swing은 스레드에 안전하지 않습니다. 자세한 내용은 Swing의 스레딩 정책을 참고하세요. 이 클래스의 직렬화된 객체는 향후 Swing 버전과 호환되지 않을 수 있습니다. 현재 직렬화 지원은 단기 저장이나 같은 버전의 Swing을 실행하는 애플리케이션 간 RMI에 적합합니다. 1.4부터 모든 JavaBean의 장기 저장 지원이 java.beans 패키지에 추가되었으니 XMLEncoder를 참고하세요.

rootPane

protected JRootPane rootPane

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

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

true이면 add와 setLayout 호출이 contentPane으로 전달됩니다. 처음에는 false이지만 JApplet이 생성될 때 true로 설정됩니다.

accessibleContext

protected AccessibleContext accessibleContext

이 JApplet과 연관된 AccessibleContext입니다.

JApplet

public JApplet() throws HeadlessException

스윙 애플릿 인스턴스를 만듭니다. 이 생성자는 컴포넌트의 로캘 프로퍼티를 JComponent.getDefaultLocale이 반환하는 값으로 설정합니다.

  • 예외: HeadlessException - GraphicsEnvironment.isHeadless()가 true를 반환하는 경우

createRootPane

protected JRootPane createRootPane()

기본 rootPane을 만들기 위해 생성자 메서드가 호출합니다.

  • 반환값: 새 JRootPane

setTransferHandler

public void setTransferHandler(TransferHandler newHandler)

transferHandler 프로퍼티를 설정합니다. 이 컴포넌트로의 데이터 전송을 지원하는 메커니즘입니다. 컴포넌트가 데이터 전송 작업을 지원하지 않으면 null을 사용합니다. 시스템 프로퍼티 suppressSwingDropSupport가 false(기본값)이고 이 컴포넌트의 현재 드롭 대상이 null이거나 사용자 설정 드롭 대상이 아니면, 이 메서드는 드롭 대상을 다음과 같이 바꿉니다. newHandler가 null이면 드롭 대상을 지웁니다. null이 아니면 새 DropTarget을 설치합니다. 참고: JApplet과 함께 사용할 때 TransferHandler는 데이터 가져오기 기능만 제공합니다. 데이터 내보내기 관련 메서드는 현재 JComponent로 타입 지정되어 있기 때문입니다.

  • 매개변수: newHandler - 새 TransferHandler
  • 버전: 1.6

getTransferHandler

public TransferHandler getTransferHandler()

transferHandler 프로퍼티를 가져옵니다.

  • 반환값: transferHandler 프로퍼티 값
  • 버전: 1.6

update

public void update(Graphics g)

paint(g)를 호출합니다. 배경을 지우는 불필요한 호출을 막기 위해 이 메서드가 재정의되었습니다.

  • 재정의: Container 클래스의 update
  • 매개변수: g - 지정된 Graphics 창

setJMenuBar

public void setJMenuBar(JMenuBar menuBar)

이 애플릿의 메뉴바를 설정합니다.

  • 매개변수: menuBar - 애플릿에 놓을 메뉴바

getJMenuBar

public JMenuBar getJMenuBar()

이 애플릿에 설정된 메뉴바를 반환합니다.

  • 반환값: 이 애플릿에 설정된 메뉴바

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

add와 setLayout 호출이 contentPane으로 전달되는지 여부를 반환합니다.

  • 반환값: add와 setLayout이 전달되면 true, 그렇지 않으면 false

setRootPaneCheckingEnabled

@BeanProperty(hidden=true, description="Whether the add and setLayout methods are forwarded") protected void setRootPaneCheckingEnabled(boolean enabled)

add와 setLayout 호출이 contentPane으로 전달되는지 여부를 설정합니다.

  • 매개변수: enabled - add와 setLayout이 전달되면 true, JApplet에 직접 작동해야 하면 false

addImpl

protected void addImpl(Component comp, Object constraints, int index)

지정된 자식 Component를 추가합니다. 이 메서드는 호출을 contentPane으로 조건부로 전달하도록 재정의되었습니다. 기본적으로 자식은 프레임 대신 contentPane에 추가됩니다.

  • 재정의: Container 클래스의 addImpl
  • 매개변수: comp - 추가할 컴포넌트
  • 예외: IllegalArgumentException - index가 유효하지 않거나 컨테이너 자신을 부모로 추가하거나 컨테이너에 창을 추가하는 경우

remove

public void remove(Component comp)

컨테이너에서 지정된 컴포넌트를 제거합니다. comp가 rootPane이 아니면 contentPane으로 호출을 전달합니다. comp가 JFrame이나 contentPane의 자식이 아니면 아무 것도 하지 않습니다.

  • 재정의: Container 클래스의 remove
  • 매개변수: comp - 제거할 컴포넌트
  • 예외: NullPointerException - comp가 null인 경우

setLayout

public void setLayout(LayoutManager manager)

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

  • 매개변수: manager - LayoutManager

getRootPane

public JRootPane getRootPane()

이 애플릿의 rootPane 객체를 반환합니다.

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

setRootPane

protected void setRootPane(JRootPane root)

rootPane 프로퍼티를 설정합니다. 생성자가 이 메서드를 호출합니다.

  • 매개변수: root - 이 애플릿의 rootPane 객체

getContentPane

public Container getContentPane()

이 애플릿의 contentPane 객체를 반환합니다.

  • 반환값: contentPane 프로퍼티 값

setContentPane

public void setContentPane(Container contentPane)

contentPane 프로퍼티를 설정합니다. 생성자가 이 메서드를 호출합니다.

  • 매개변수: contentPane - 이 애플릿의 contentPane 객체
  • 예외: IllegalComponentStateException - content pane 매개변수가 null인 경우

getLayeredPane

public JLayeredPane getLayeredPane()

이 애플릿의 layeredPane 객체를 반환합니다.

  • 반환값: layeredPane 프로퍼티 값

setLayeredPane

public void setLayeredPane(JLayeredPane layeredPane)

layeredPane 프로퍼티를 설정합니다. 생성자가 이 메서드를 호출합니다.

  • 매개변수: layeredPane - 이 애플릿의 layeredPane 객체

getGlassPane

public Component getGlassPane()

이 애플릿의 glassPane 객체를 반환합니다.

  • 반환값: glassPane 프로퍼티 값

setGlassPane

public void setGlassPane(Component glassPane)

glassPane 프로퍼티를 설정합니다. 생성자가 이 메서드를 호출합니다.

  • 매개변수: glassPane - 이 애플릿의 glassPane 객체

getGraphics

public Graphics getGraphics()

이 컴포넌트의 그래픽 컨텍스트를 만듭니다. 이 컴포넌트가 현재 표시 가능하지 않으면 null을 반환합니다.

  • 재정의: Component 클래스의 getGraphics
  • 반환값: 이 컴포넌트의 그래픽 컨텍스트, 없으면 null
  • 버전: 1.6

repaint

public void repaint(long time, int x, int y, int width, int height)

time 밀리초 이내에 이 컴포넌트의 지정된 사각형을 다시 그립니다.

  • 재정의: Component 클래스의 repaint
  • 매개변수: time - 갱신 전 최대 밀리초
  • 매개변수: x, y - 좌표, width·height - 크기
  • 버전: 1.6

paramString

protected String paramString()

이 JApplet의 문자열 표현을 반환합니다. 이 메서드는 디버깅 목적으로만 사용되며, 반환 문자열의 내용과 형식은 구현마다 다를 수 있습니다. 반환 문자열은 비어 있을 수 있지만 null일 수는 없습니다.

  • 재정의: Container 클래스의 paramString
  • 반환값: 이 JApplet의 문자열 표현

getAccessibleContext

public AccessibleContext getAccessibleContext()

이 JApplet과 연관된 AccessibleContext를 가져옵니다. JApplet의 경우 AccessibleContext는 AccessibleJApplet의 형태를 취합니다. 필요한 경우 새 AccessibleJApplet 인스턴스가 생성됩니다.

  • 재정의: Applet 클래스의 getAccessibleContext
  • 반환값: 이 JApplet의 AccessibleContext 역할을 하는 AccessibleJApplet

더 알아보기