JavaTM Platform
Standard Ed. 6

javax.swing
클래스 JApplet

java.lang.Object 
  상위를 확장 java.awt.Component 
      상위를 확장 java.awt.Container 
          상위를 확장 java.awt.Panel 
              상위를 확장 java.applet.Applet 
                  상위를 확장 javax.swing.JApplet
모든 구현된 인터페이스:
ImageObserver , MenuContainer , Serializable , Accessible , RootPaneContainer


public class JApplet
extends Applet
implements Accessible , RootPaneContainer

JFC/Swing 컴퍼넌트 아키텍쳐(architecture)의 지원를 추가하는 java.applet.Applet 의 확장 버젼입니다. JApplet 의 사용에 관한 태스크 지향의 문서는, 「The Java Tutorial」의「How to Make Applets」를 참조해 주세요.  

JApplet 클래스는,java.applet.Applet 와 다소 호환성이 없는 곳이 있습니다. JApplet 에는,JRootPane 가 유일한 아이로서 포함됩니다. contentPane 는,JApplet 의 모든 아이의 부모가 됩니다. 편의상,add 와 그 파생 메소드,removesetLayout 는, 필요에 따라서 contentPane 에 전송 되도록(듯이) 오버라이드(override) 되고 있습니다. 즉, 다음과 같이 기술할 수 있습니다.

applet.add(child);
 
아이는 contentPane 에 추가됩니다. contentPane 는 항상 null 이외의 값이 됩니다. 이것을 null 로 설정하려고 하면(자),JApplet 에 의해 예외가 throw 됩니다. 디폴트의 contentPane 에는,BorderLayout 매니저가 설정됩니다. JAppletLayoutManager 의 추가, 삭제, 및 설정의 상세한 것에 대하여는,RootPaneContainer 를 참조해 주세요.  

contentPane,glassPane, 및 layeredPane 프로퍼티의 상세한 것에 대하여는,JRootPane 의 설명을 참조해 주세요.  

경고: Swing 는 thread에 대해서 안전하지는 않습니다. 자세한 것은,「Swing's Threading Policy」를 참조해 주세요.  

경고: 이 클래스의 직렬화 된 객체는, 향후의 Swing 릴리스와 호환은 아니게 될 예정입니다. 현재의 직렬화의 지원는, 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. JDK Version 1.4 이후, 모든 JavaBeans 의 장기간의 운용 지원는,java.beans 패키지에 추가되고 있습니다. 자세한 것은,XMLEncoder 를 참조해 주세요.

관련 항목:
RootPaneContainer

상자의 클래스의 개요
protected  class JApplet.AccessibleJApplet
          이 클래스는 JApplet 클래스용의 접근성? 지원를 구현하고 있습니다.
 
클래스 java.applet. Applet 로부터 상속된 상자의 클래스/인터페이스
Applet.AccessibleApplet
 
클래스 java.awt. Panel 로부터 상속된 상자의 클래스/인터페이스
Panel.AccessibleAWTPanel
 
클래스 java.awt. Container 로부터 상속된 상자의 클래스/인터페이스
Container.AccessibleAWTContainer
 
클래스 java.awt. Component 로부터 상속된 상자의 클래스/인터페이스
Component.AccessibleAWTComponent , Component.BaselineResizeBehavior , Component.BltBufferStrategy , Component.FlipBufferStrategy
 
필드의 개요
protected  AccessibleContext accessibleContext
           
protected  JRootPane rootPane
           
protected  boolean rootPaneCheckingEnabled
          true 의 경우는,addsetLayout 의 호출이 contentPane 에 전송 됩니다.
 
클래스 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
 
생성자 의 개요
JApplet ()
          Swing 애플릿의 인스턴스를 생성합니다.
 
메소드의 개요
protected  void addImpl (Component  comp, Object  constraints, int index)
          지정된 아이 Component 를 추가합니다.
protected  JRootPane createRootPane ()
          생성자 메소드에 의해 불려 가 디폴트의 rootPane 를 생성합니다.
 AccessibleContext getAccessibleContext ()
          이 JApplet 에 관련한 AccessibleContext 를 가져옵니다.
 Container getContentPane ()
          애플릿의 contentPane 객체를 돌려줍니다.
 Component getGlassPane ()
          애플릿의 glassPane 객체를 돌려줍니다.
 Graphics getGraphics ()
          이 컴퍼넌트의 그래픽스 문맥을 작성합니다.
 JMenuBar getJMenuBar ()
          애플릿으로 설정된 도구모음을 돌려줍니다.
 JLayeredPane getLayeredPane ()
          애플릿의 layeredPane 객체를 돌려줍니다.
 JRootPane getRootPane ()
          애플릿의 rootPane 객체를 돌려줍니다.
 TransferHandler getTransferHandler ()
          transferHandler 프로퍼티을 돌려줍니다.
protected  boolean isRootPaneCheckingEnabled ()
          addsetLayout 의 호출이 contentPane 에 전송 될지 어떨지를 돌려줍니다.
protected  String paramString ()
          이 JApplet 의 캐릭터 라인 표현을 돌려줍니다.
 void remove (Component  comp)
          지정된 컴퍼넌트를 컨테이너로부터 삭제합니다.
 void repaint (long time, int x, int y, int width, int height)
          이 컴퍼넌트의 지정된 구형 영역을 time 밀리 세컨드 이내에 재draw 합니다.
 void setContentPane (Container  contentPane)
          contentPane 프로퍼티을 설정합니다.
 void setGlassPane (Component  glassPane)
          glassPane 프로퍼티을 설정합니다.
 void setJMenuBar (JMenuBar  menuBar)
          애플릿의 도구모음을 설정합니다.
 void setLayeredPane (JLayeredPane  layeredPane)
          layeredPane 프로퍼티을 설정합니다.
 void setLayout (LayoutManager  manager)
          LayoutManager 를 설정합니다.
protected  void setRootPane (JRootPane  root)
          rootPane 프로퍼티을 설정합니다.
protected  void setRootPaneCheckingEnabled (boolean enabled)
          addsetLayout 의 호출이 contentPane 에 전송 될지 어떨지를 설정합니다.
 void setTransferHandler (TransferHandler  newHandler)
          이 컴퍼넌트에의 데이터 전송을 지원하는 기구인,transferHandler 프로퍼티을 설정합니다.
 void update (Graphics  g)
          paint(g) 를 호출합니다.
 
클래스 java.applet. Applet 로부터 상속된 메소드
destroy , getAppletContext , getAppletInfo , getAudioClip , getAudioClip , getCodeBase , getDocumentBase , getImage , getImage , getLocale , getParameter , getParameterInfo , init , isActive , newAudioClip , play , play , resize , resize , setStub , showStatus , start , stop
 
클래스 java.awt. Panel 로부터 상속된 메소드
addNotify
 
클래스 java.awt. Container 로부터 상속된 메소드
add , add , add , add , add , addContainerListener , addPropertyChangeListener , addPropertyChangeListener , applyComponentOrientation , areFocusTraversalKeysSet , countComponents , deliverEvent , doLayout , findComponentAt , findComponentAt , getAlignmentX , getAlignmentY , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getComponentZOrder , getContainerListeners , getFocusTraversalKeys , getFocusTraversalPolicy , getInsets , getLayout , getListeners , getMaximumSize , getMinimumSize , getMousePosition , getPreferredSize , insets , invalidate , isAncestorOf , isFocusCycleRoot , isFocusCycleRoot , isFocusTraversalPolicyProvider , isFocusTraversalPolicySet , layout , list , list , locate , minimumSize , paint , paintComponents , preferredSize , print , printComponents , processContainerEvent , processEvent , remove , removeAll , removeContainerListener , removeNotify , setComponentZOrder , setFocusCycleRoot , setFocusTraversalKeys , setFocusTraversalPolicy , setFocusTraversalPolicyProvider , setFont , transferFocusBackward , transferFocusDownCycle , 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 , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeysEnabled , getFont , getFontMetrics , getForeground , getGraphicsConfiguration , getHeight , getHierarchyBoundsListeners , getHierarchyListeners , getIgnoreRepaint , getInputContext , getInputMethodListeners , getInputMethodRequests , getKeyListeners , getLocation , getLocation , getLocationOnScreen , getMouseListeners , getMouseMotionListeners , getMousePosition , getMouseWheelListeners , getName , getParent , getPeer , getPropertyChangeListeners , getPropertyChangeListeners , getSize , getSize , getToolkit , getTreeLock , getWidth , getX , getY , gotFocus , handleEvent , hasFocus , hide , imageUpdate , inside , isBackgroundSet , isCursorSet , isDisplayable , isDoubleBuffered , isEnabled , isFocusable , isFocusOwner , isFocusTraversable , isFontSet , isForegroundSet , isLightweight , isMaximumSizeSet , isMinimumSizeSet , isOpaque , isPreferredSizeSet , isShowing , isValid , isVisible , keyDown , keyUp , list , list , list , location , lostFocus , mouseDown , mouseDrag , mouseEnter , mouseExit , mouseMove , mouseUp , move , nextFocus , paintAll , postEvent , 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 , requestFocus , requestFocus , requestFocusInWindow , requestFocusInWindow , reshape , setBackground , setBounds , setBounds , setComponentOrientation , setCursor , setDropTarget , setEnabled , setFocusable , setFocusTraversalKeysEnabled , setForeground , setIgnoreRepaint , setLocale , setLocation , setLocation , setMaximumSize , setMinimumSize , setName , setPreferredSize , setSize , setSize , setVisible , show , show , size , toString , transferFocus , transferFocusUpCycle
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait
 

필드의 상세

rootPane

protected JRootPane  rootPane
관련 항목:
getRootPane() , setRootPane(javax.swing.JRootPane)

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled
true 의 경우는,addsetLayout 의 호출이 contentPane 에 전송 됩니다. 처음은 false 입니다만,JApplet 가 구축되면(자), true 로 설정됩니다.

관련 항목:
isRootPaneCheckingEnabled() , setRootPaneCheckingEnabled(boolean) , RootPaneContainer

accessibleContext

protected AccessibleContext  accessibleContext
생성자 의 상세

JApplet

public JApplet()
        throws HeadlessException 
Swing 애플릿의 인스턴스를 생성합니다.  

이 생성자 은 컴퍼넌트의 로컬 프로퍼티을 JComponent.getDefaultLocale 에 의해 반환된 값으로 설정합니다.

예외:
HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우
관련 항목:
GraphicsEnvironment.isHeadless() , JComponent.getDefaultLocale()
메소드의 상세

createRootPane

protected JRootPane  createRootPane()
생성자 메소드에 의해 불려 가 디폴트의 rootPane 를 생성합니다.


setTransferHandler

public void setTransferHandler(TransferHandler  newHandler)
이 컴퍼넌트에의 데이터 전송을 지원하는 기구인,transferHandler 프로퍼티을 설정합니다. 컴퍼넌트가 데이터 전송 조작을 지원하지 않는 경우,null 를 사용합니다.  

시스템 프로퍼티 suppressSwingDropSupportfalse (디폴트)이며, 이 컴퍼넌트상의 현재의 드롭 타겟이 null 인지, 사용자 설정의 드롭 타겟이 아닌 경우, 이 메소드는 드롭 타겟을 다음과 같이 변경합니다. newHandlernull 의 경우, 드롭 타겟을 소거합니다. null 가 아닌 경우는, 새로운 DropTarget 를 인스톨 합니다.  

주:JApplet 와 조합해 사용했을 경우,TransferHandler 는 데이터의 임포트 기능 밖에 제공하지 않습니다. 이것은, 데이터의 export 관련의 메소드가 현재 JComponent 형이 되어 있기 (위해)때문에입니다.  

자세한 것은, 「The Java Tutorial」의「How to Use Drag and Drop and Data Transfer」를 참조해 주세요.

파라미터:
newHandler - 새로운 TransferHandler
도입된 버젼:
1.6
관련 항목:
TransferHandler , getTransferHandler() , Component.setDropTarget(java.awt.dnd.DropTarget)

getTransferHandler

public TransferHandler  getTransferHandler()
transferHandler 프로퍼티을 돌려줍니다.

반환값:
transferHandler 프로퍼티의 값
도입된 버젼:
1.6
관련 항목:
TransferHandler , setTransferHandler(javax.swing.TransferHandler)

update

public void update(Graphics  g)
paint(g) 를 호출합니다. 이 메소드는, 백그라운드를 클리어 하는 불필요한 호출을 하지 않게 하기 위해서 오버라이드(override) 되었습니다.

오버라이드(override):
클래스 Container 내의 update
파라미터:
g - 지정된 Graphics 윈도우
관련 항목:
Component.update(Graphics)

setJMenuBar

public void setJMenuBar(JMenuBar  menuBar)
애플릿의 도구모음을 설정합니다.

파라미터:
menuBar - 애플릿내에 배치중의 도구모음
관련 항목:
getJMenuBar()

getJMenuBar

public JMenuBar  getJMenuBar()
애플릿으로 설정된 도구모음을 돌려줍니다.

관련 항목:
setJMenuBar(javax.swing.JMenuBar)

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()
addsetLayout 의 호출이 contentPane 에 전송 될지 어떨지를 돌려줍니다.

반환값:
addsetLayout 가 전송 되는 경우는 true, 그렇지 않은 경우는 false
관련 항목:
addImpl(java.awt.Component, java.lang.Object, int) , setLayout(java.awt.LayoutManager) , setRootPaneCheckingEnabled(boolean) , RootPaneContainer

setRootPaneCheckingEnabled

protected void setRootPaneCheckingEnabled(boolean enabled)
addsetLayout 의 호출이 contentPane 에 전송 될지 어떨지를 설정합니다.

파라미터:
enabled - addsetLayout 가 전송 되는 경우는 true,JApplet 로 직접 실행할 필요가 있는 경우는 false
관련 항목:
addImpl(java.awt.Component, java.lang.Object, int) , setLayout(java.awt.LayoutManager) , isRootPaneCheckingEnabled() , RootPaneContainer

addImpl

protected void addImpl(Component  comp,
                       Object  constraints,
                       int index)
지정된 아이 Component 를 추가합니다. 이 메소드를 오버라이드(override) 하면(자), 호출이 조건부로 contentPane 에 전송 됩니다. 디폴트에서는, 아이는 프레임은 아니고 contentPane 에 추가됩니다. 상세한 것에 대하여는,RootPaneContainer 를 참조해 주세요.

오버라이드(override):
클래스 Container 내의 addImpl
파라미터:
comp - 확장되는 컴퍼넌트
constraints - 준수되어야 할 제약
index - 인덱스
예외:
IllegalArgumentException - index 가 무효인 경우
IllegalArgumentException - 컨테이너의 부모를 그 컨테이너 자체에 추가하려고 하고 있는 경우
IllegalArgumentException - 윈도우를 컨테이너에 추가하려고 하고 있는 경우
관련 항목:
setRootPaneCheckingEnabled(boolean) , RootPaneContainer

remove

public void remove(Component  comp)
지정된 컴퍼넌트를 컨테이너로부터 삭제합니다. comprootPane 가 아닌 경우는, 호출이 contentPane 에 전송 됩니다. compJFrame 또는 contentPane 의 아이가 아닌 경우는, 아무것도 행해지지 않습니다.

오버라이드(override):
클래스 Container 내의 remove
파라미터:
comp - 삭제되는 컴퍼넌트
예외:
NullPointerException - comp 가 null 의 경우
관련 항목:
Container.add(java.awt.Component) , RootPaneContainer

setLayout

public void setLayout(LayoutManager  manager)
LayoutManager 를 설정합니다. 이 메소드를 오버라이드(override) 하면(자), 호출이 조건부로 contentPane 에 전송 됩니다. 상세한 것에 대하여는,RootPaneContainer 를 참조해 주세요.

오버라이드(override):
클래스 Container 내의 setLayout
파라미터:
manager - LayoutManager
관련 항목:
setRootPaneCheckingEnabled(boolean) , RootPaneContainer

getRootPane

public JRootPane  getRootPane()
애플릿의 rootPane 객체를 돌려줍니다.

정의:
인터페이스 RootPaneContainer 내의 getRootPane
반환값:
이 컴퍼넌트의 단일의 JRootPane 의 아이
관련 항목:
setRootPane(javax.swing.JRootPane) , RootPaneContainer.getRootPane()

setRootPane

protected void setRootPane(JRootPane  root)
rootPane 프로퍼티을 설정합니다. 이 메소드는 생성자 에 의해 불려 갑니다.

파라미터:
root - 이 애플릿의 rootPane 객체
관련 항목:
getRootPane()

getContentPane

public Container  getContentPane()
애플릿의 contentPane 객체를 돌려줍니다.

정의:
인터페이스 RootPaneContainer 내의 getContentPane
반환값:
contentPane 프로퍼티의 값
관련 항목:
setContentPane(java.awt.Container) , RootPaneContainer.getContentPane()

setContentPane

public void setContentPane(Container  contentPane)
contentPane 프로퍼티을 설정합니다. 이 메소드는 생성자 에 의해 불려 갑니다.

정의:
인터페이스 RootPaneContainer 내의 setContentPane
파라미터:
contentPane - 이 애플릿의 contentPane 객체
예외:
IllegalComponentStateException - 컨텐츠 구획 파라미터가 null 의 경우 (실행시 예외)
관련 항목:
getContentPane() , RootPaneContainer.setContentPane(java.awt.Container)

getLayeredPane

public JLayeredPane  getLayeredPane()
애플릿의 layeredPane 객체를 돌려줍니다.

정의:
인터페이스 RootPaneContainer 내의 getLayeredPane
반환값:
layeredPane 프로퍼티의 값
예외:
IllegalComponentStateException - 계층화 구획 파라미터가 null 의 경우 (실행시 예외)
관련 항목:
setLayeredPane(javax.swing.JLayeredPane) , RootPaneContainer.getLayeredPane()

setLayeredPane

public void setLayeredPane(JLayeredPane  layeredPane)
layeredPane 프로퍼티을 설정합니다. 이 메소드는 생성자 에 의해 불려 갑니다.

정의:
인터페이스 RootPaneContainer 내의 setLayeredPane
파라미터:
layeredPane - 이 애플릿의 layeredPane 객체
관련 항목:
getLayeredPane() , RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)

getGlassPane

public Component  getGlassPane()
애플릿의 glassPane 객체를 돌려줍니다.

정의:
인터페이스 RootPaneContainer 내의 getGlassPane
반환값:
glassPane 프로퍼티의 값
관련 항목:
setGlassPane(java.awt.Component) , RootPaneContainer.getGlassPane()

setGlassPane

public void setGlassPane(Component  glassPane)
glassPane 프로퍼티을 설정합니다. 이 메소드는 생성자 에 의해 불려 갑니다.

정의:
인터페이스 RootPaneContainer 내의 setGlassPane
파라미터:
glassPane - 이 애플릿의 glassPane 객체
관련 항목:
getGlassPane() , RootPaneContainer.setGlassPane(java.awt.Component)

getGraphics

public Graphics  getGraphics()
이 컴퍼넌트의 그래픽스 문맥을 작성합니다. 이 메소드는, 컴퍼넌트가 현재 표시 가능하지 않은 경우,null 를 돌려줍니다.

오버라이드(override):
클래스 Component 내의 getGraphics
반환값:
이 컴퍼넌트의 그래픽스 문맥. 없는 경우는 null
도입된 버젼:
1.6
관련 항목:
Component.paint(java.awt.Graphics)

repaint

public void repaint(long time,
                    int x,
                    int y,
                    int width,
                    int height)
이 컴퍼넌트의 지정된 구형 영역을 time 밀리 세컨드 이내에 재draw 합니다. 재페인트의 방법의 자세한 것은,RepaintManager 를 참조해 주세요.

오버라이드(override):
클래스 Component 내의 repaint
파라미터:
time - 갱신까지의 최대 시간 (밀리 세컨드)
x - x 좌표
y - y 좌표
width - 폭
height - 높이
도입된 버젼:
1.6
관련 항목:
RepaintManager

paramString

protected String  paramString()
이 JApplet 의 캐릭터 라인 표현을 돌려줍니다. 이 메소드는 디버그 전용이며, 반환되는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 반환되는 캐릭터 라인은 빈 상태(empty)의 경우가 있습니다만,null 로는 되지 않습니다.

오버라이드(override):
클래스 Container 내의 paramString
반환값:
이 JApplet 의 캐릭터 라인 표현

getAccessibleContext

public AccessibleContext  getAccessibleContext()
이 JApplet 에 관련한 AccessibleContext 를 가져옵니다. JApplet 의 경우, AccessibleContext 는 AccessibleJApplet 의 형식을 취합니다. 필요에 따라서 신규의 AccessibleJApplet 인스턴스가 생성됩니다.

정의:
인터페이스 Accessible 내의 getAccessibleContext
오버라이드(override):
클래스 Applet 내의 getAccessibleContext
반환값:
이 JApplet 의 AccessibleContext 로서 기능하는 AccessibleJApplet

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 도 참조해 주세요.