java.applet
클래스 Applet

java.lang.Object 
  java.awt.Component 
      java.awt.Container 
          java.awt.Panel 
              java.applet.Applet

모든 구현된 인터페이스:

ImageObserver , MenuContainer , Serializable , Accessible

직계의 기존의 서브 클래스:

JApplet

public class Applet
extends Panel 

애플릿이란, 단독으로 동작할 것은 없고, 다른 어플리케이션안에 짜넣어진 형태로 실행되는 작은 프로그램입니다.

Applet 클래스는, Web 페이지에 파묻히는 애플릿, 또는 Java 애플릿 viewer로 표시되는 애플릿의 슈퍼 클래스입니다. Applet 클래스는, 애플릿과 그 환경과의 사이의 표준 인터페이스의 역할을 완수합니다.

도입된 버젼:

JDK1. 0

관련 항목:

직렬화 된 형식

상자의 클래스의 개요

protected class

Applet.AccessibleApplet 이 클래스는 Applet 클래스용의 접근성?의 지원를 구현하고 있습니다.

클래스 java.awt. Panel 로부터 상속된 상자의 클래스/인터페이스

Panel.AccessibleAWTPanel

클래스 java.awt. Container 로부터 상속된 상자의 클래스/인터페이스

Container.AccessibleAWTContainer

클래스 java.awt. Component 로부터 상속된 상자의 클래스/인터페이스

Component.AccessibleAWTComponent , Component.BaselineResizeBehavior , Component.BltBufferStrategy , Component.FlipBufferStrategy

필드의 개요

클래스 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

생성자 의 개요

Applet ()
새로운 Applet 를 구축합니다.

메소드의 개요

void	destroy () 브라우저 또는 애플릿 viewer에 의해 불려 가 이 애플릿의 재생중에, 할당할 수 있던 모든 자원을 파기할 필요가 있는 것을 통지합니다.
AccessibleContext	getAccessibleContext () 이 애플릿에 관련한 AccessibleContext 를 돌려줍니다.
AppletContext	getAppletContext () 애플릿의 문맥을 가져옵니다.
String	getAppletInfo () 애플릿에 대한 정보를 돌려줍니다.
AudioClip	getAudioClip (URL url) 인수 url 로 지정된 AudioClip 객체를 돌려줍니다.
AudioClip	getAudioClip (URL url, String name) 인수 url 와 name 로 지정된 AudioClip 객체를 돌려줍니다.
URL	getCodeBase () 베이스 URL 를 돌려줍니다.
URL	getDocumentBase () 이 애플릿이 짜넣어지고 있는 문서의 URL 를 가져옵니다.
Image	getImage (URL url) Image 객체를 돌려줍니다.
Image	getImage (URL url, String name) Image 객체를 돌려줍니다.
Locale	getLocale () 애플릿의 로케일을 가져옵니다.
String	getParameter (String name) HTML 태그내에 있는 지정된 파라미터의 값을 돌려줍니다.
String [][]	getParameterInfo () 이 애플릿이 해석하는 파라미터에 대한 정보를 돌려줍니다.
void	init () 브라우저 또는 애플릿 viewer에 의해 불려 가 이 애플릿이 시스템에 로드 된 것을 통지합니다.
boolean	isActive () 애플릿이 액티브한가 어떤가를 판정합니다.
static AudioClip	newAudioClip (URL url) 지정된 URL 로부터 오디오 클립을 가져옵니다.
void	play (URL url) 지정된 절대 URL 에 있는 오디오 클립을 재생합니다.
void	play (URL url, String name) URL 와 그 URL 와의 상대 위치에서 지정된 오디오 클립을 재생합니다.
void	resize (Dimension d) 애플릿의 사이즈 변경을 요구합니다.
void	resize (int width, int height) 애플릿의 사이즈 변경을 요구합니다.
void	setStub (AppletStub stub) 애플릿의 Stub를 설정합니다.
void	showStatus (String msg) 인수로 지정된 캐릭터 라인을 「상태 윈도우」에 표시하도록(듯이) 요구합니다.
void	start () 브라우저 또는 애플릿 viewer에 의해 불려 가 이 애플릿의 실행을 개시할 필요가 있는 것을 통지합니다.
void	stop () 브라우저 또는 애플릿 viewer에 의해 불려 가 이 애플릿의 실행을 정지할 필요가 있는 것을 통지합니다.

클래스 java.awt. Panel 로부터 상속된 메소드

addNotify

클래스 java.awt. Container 로부터 상속된 메소드

add , add , add , add , add , addContainerListener , addImpl , 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 , paramString , preferredSize , print , printComponents , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , removeNotify , setComponentZOrder , setFocusCycleRoot , 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 , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeysEnabled , getFont , getFontMetrics , getForeground , getGraphics , 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 , 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

생성자 의 상세

Applet

public Applet()
       throws HeadlessException 

새로운 Applet 를 구축합니다.

주:java.applet.Applet 가 많은 메소드는, 애플릿이 완전하게 구축되고 나서 그 애플릿에 의해 호출할 수가 있습니다. 생성자 내에서 java.applet.Applet 의 메소드를 호출하지 않게 해 주세요.

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

도입된 버젼:

1.4

관련 항목:

GraphicsEnvironment.isHeadless()

메소드의 상세

setStub

public final void setStub(AppletStub  stub)

애플릿의 Stub를 설정합니다. 이 처리는, 시스템에 의해 자동적으로 행해집니다.

시큐리티 매니저가 존재하는 경우는, Stub가 벌써 설정되어 있으면(자),AWTPermission("setAppletStub") 액세스권에 의해 checkPermission 메소드를 호출합니다.

파라미터:

stub - 새로운 Stub

예외:

SecurityException - 호출측이 Stub를 설정할 수 없는 경우

isActive

public boolean isActive()

애플릿이 액티브한가 어떤가를 판정합니다. 애플릿은,start 메소드가 불려 가기 직전에 액티브하게 되어,stop 메소드가 불려 가기 직전에 액티브하지 않게 됩니다.

반환값:

애플릿이 액티브한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

start() , stop()

getDocumentBase

public URL  getDocumentBase()

이 애플릿이 짜넣어지고 있는 문서의 URL 를 가져옵니다. 예를 들어, 다음의 문서내에 애플릿이 포함되어 있다고 합니다.

    http://java.sun.com/products/jdk/1. 2/index.html
 

문서의 베이스는 다음과 같습니다.

    http://java.sun.com/products/jdk/1. 2/index.html
 

반환값:

이 애플릿을 포함한 문서 URL

관련 항목:

getCodeBase()

getCodeBase

public URL  getCodeBase()

베이스 URL 를 돌려줍니다. 베이스 URL 는, 이 애플릿을 포함한 디렉토리의 URL 입니다.

반환값:

이 애플릿을 포함한 디렉토리의 기저 URL

관련 항목:

getDocumentBase()

getParameter

public String  getParameter(String  name)

HTML 태그내에 있는 지정된 파라미터의 값을 돌려줍니다. 예를 들어, 애플릿이 다음과 같이 지정되고 있다고 합니다.

 <applet code="Clock" width=50 height=50>
 <param name=Color value="blue">
 </applet>
 

이 경우,getParameter("Color") 의 호출은 "blue" 라고 하는 값을 돌려줍니다.

인수 name 에서는 대문자와 소문자를 구별하지 않습니다.

파라미터:

name - 파라미터명

반환값:

이름 첨부 파라미터의 값. 설정되어 있지 않은 경우는 null

getAppletContext

public AppletContext  getAppletContext()

애플릿의 문맥을 가져옵니다. 애플릿은, 문맥을 사용해 애플릿의 실행 환경에 관한 정보를 얻거나 실행 환경을 제어하거나 할 수가 있습니다.

애플릿의 환경이란, 애플릿을 포함하고 있는 문서를 나타냅니다.

반환값:

애플릿의 문맥

resize

public void resize(int width,
                   int height)

애플릿의 사이즈 변경을 요구합니다.

오버라이드(override):

클래스 Component 내의 resize

파라미터:

width - 애플릿에 새롭게 요구된 폭

height - 애플릿에 새롭게 요구된 높이

resize

public void resize(Dimension  d)

애플릿의 사이즈 변경을 요구합니다.

오버라이드(override):

클래스 Component 내의 resize

파라미터:

d - 새로운 폭과 높이를 나타내는 객체

showStatus

public void showStatus(String  msg)

인수로 지정된 캐릭터 라인을 「상태 윈도우」에 표시하도록(듯이) 요구합니다. 많은 브라우저나 애플릿 viewer에는 상태 윈도우가 있어, 어플리케이션은 이 윈도우를 사용해 사용자에게 현재 상태를 전할 수가 있습니다.

파라미터:

msg - 상태 윈도우에 표시되는 캐릭터 라인

getImage

public Image  getImage(URL  url)

Image 객체를 돌려줍니다. 이 객체는, 화면에 draw 할 수가 있습니다. 인수 url 에는, 절대 URL 를 지정합니다.

이 메소드는, 이미지가 있을지 어떨지에 관계없이, 곧바로 복귀합니다. 애플릿이 화면에 이미지를 draw 하려고 했을 때에, 데이터가 로드 됩니다. 이미지는 조금씩 화면에 draw 되어 갑니다.

파라미터:

url - 이미지의 위치를 나타내는 절대 URL

반환값:

지정된 URL 에 있는 이미지

관련 항목:

Image

getImage

public Image  getImage(URL  url,
                      String  name)

Image 객체를 돌려줍니다. 이 객체는, 화면에 draw 할 수가 있습니다. 인수 url 에는 절대 URL 를 지정합니다. 인수 name 에는, 인수 url 와의 상대 위치를 지정합니다.

이 메소드는, 이미지가 있을지 어떨지에 관계없이, 곧바로 복귀합니다. 애플릿이 화면에 이미지를 draw 하려고 했을 때에, 데이터가 로드 됩니다. 이미지는 조금씩 화면에 draw 되어 갑니다.

파라미터:

url - 이미지의 베이스 위치를 나타내는 절대 URL

name - 이미지의 위치. 인수 url 인수와의 상대 위치에서 지정한다

반환값:

지정된 URL 에 있는 이미지

관련 항목:

Image

newAudioClip

public static final AudioClip  newAudioClip(URL  url)

지정된 URL 로부터 오디오 클립을 가져옵니다.

파라미터:

url - 오디오 클립의 위치

반환값:

지정된 URL 에 있는 오디오 클립

도입된 버젼:

1.2

getAudioClip

public AudioClip  getAudioClip(URL  url)

인수 url 로 지정된 AudioClip 객체를 돌려줍니다.

이 메소드는, 오디오 클립이 있을지 어떨지에 관계없이, 곧바로 복귀합니다. 애플릿이 오디오 클립을 재생하려고 했을 때에, 데이터가 로드 됩니다.

파라미터:

url - 오디오 클립의 위치를 나타내는 절대 URL

반환값:

지정된 URL 에 있는 오디오 클립

관련 항목:

AudioClip

getAudioClip

public AudioClip  getAudioClip(URL  url,
                              String  name)

인수 url 와 name 로 지정된 AudioClip 객체를 돌려줍니다.

이 메소드는, 오디오 클립이 있을지 어떨지에 관계없이, 곧바로 복귀합니다. 애플릿이 오디오 클립을 재생하려고 했을 때에, 데이터가 로드 됩니다.

파라미터:

url - 오디오 클립의 베이스 위치를 나타내는 절대 URL

name - 오디오 클립의 위치. 인수 url 와의 상대 위치에서 지정한다

반환값:

지정된 URL 에 있는 오디오 클립

관련 항목:

AudioClip

getAppletInfo

public String  getAppletInfo()

애플릿에 대한 정보를 돌려줍니다. 애플릿은, 이 메소드를 오버라이드(override) 해, 애플릿의 작성자, 버젼, 및 저작권에 대한 정보를 포함한 String 객체를 돌려줍니다.

Applet 클래스의 이 메소드의 구현은,null 를 돌려줍니다.

반환값:

애플릿의 작성자, 버젼, 및 저작권에 대한 정보를 포함한 캐릭터 라인

getLocale

public Locale  getLocale()

애플릿의 로케일을 가져옵니다. 애플릿은, 브라우저 또는 애플릿 viewer의 로케일로부터 독립한, 독자적인 로케일을 보관 유지할 수 있습니다.

오버라이드(override):

클래스 Component 내의 getLocale

반환값:

애플릿의 로케일. 로케일이 설정되어 있지 않은 경우는, 디폴트의 로케일을 돌려주는

도입된 버젼:

JDK1. 1

관련 항목:

Component.setLocale(java.util.Locale)

getParameterInfo

public String [][] getParameterInfo()

이 애플릿이 해석하는 파라미터에 대한 정보를 돌려줍니다. 애플릿은, 이 메소드를 오버라이드(override) 해, 이러한 파라미터에 대한 정보를 포함한 String 의 배열을 돌려줍니다.

배열의 각 요소는 3 개의 String 세트로, 이름, 형태, 및 설명을 포함합니다. 다음에 예를 나타냅니다.

 String pinfo[][] = {
         {"fps",    "1-10",    "frames per second"},
         {"repeat", "boolean", "repeat image loop"},
         {"imgs",   "url",     "images directory"}
 };
 

Applet 클래스의 이 메소드의 구현은,null 를 돌려줍니다.

반환값:

이 애플릿이 받는 파라미터에 대한 정보를 포함한 배열

play

public void play(URL  url)

지정된 절대 URL 에 있는 오디오 클립을 재생합니다. 오디오 클립이 발견되지 않는 경우는 아무것도 실시하지 않습니다.

파라미터:

url - 오디오 클립의 위치를 나타내는 절대 URL

play

public void play(URL  url,
                 String  name)

URL 와 그 URL 와의 상대 위치에서 지정된 오디오 클립을 재생합니다. 오디오 클립이 발견되지 않는 경우는 아무것도 실시하지 않습니다.

파라미터:

url - 오디오 클립의 베이스 위치를 나타내는 절대 URL

name - 오디오 클립의 위치. 인수 url 와의 상대 위치에서 지정한다

init

public void init()

브라우저 또는 애플릿 viewer에 의해 불려 가 이 애플릿이 시스템에 로드 된 것을 통지합니다. 이 메소드는,start 메소드가 최초로 불려 가기 전에 항상 불려 갑니다.

Applet 의 서브 클래스에서 초기화 처리를 실시하는 경우는, 이 메소드를 오버라이드(override) 할 필요가 있습니다. 예를 들어, thread를 사용하는 애플릿의 경우는,init 메소드로 thread를 작성해,destroy 메소드로 thread를 파기합니다.

Applet 클래스의 이 메소드에서는 아무것도 실시하지 않습니다.

관련 항목:

destroy() , start() , stop()

start

public void start()

브라우저 또는 애플릿 viewer에 의해 불려 가 이 애플릿의 실행을 개시할 필요가 있는 것을 통지합니다. 이 메소드는,init 메소드의 후에 불려 가 Web 페이지상에서 애플릿이 액티브하게 될 때마다 불려 갑니다.

애플릿을 포함한 Web 페이지가 표시될 때마다 하등의 처리를 실시하는 경우는,Applet 의 서브 클래스에서는 이 메소드를 오버라이드(override) 할 필요가 있습니다. 예를 들어, 애니메이션을 포함한 애플릿의 경우는,start 메소드로 애니메이션을 재생해,stop 메소드로 애니메이션을 정지합니다.

주:getLocationOnScreen 등의 메소드의 몇개인가는, 애플릿이 표시되고 있는 경우는 의미가 있는 결과 밖에 제공할 수 없습니다. 애플릿의 start 가 먼저 불려 갔을 경우,isShowing 는 false 를 돌려주므로,true 를 돌려주기 위해서(때문에) 필요한 isShowing 는 ComponentListener 로부터 불려 갈 필요가 있습니다.

Applet 클래스의 이 메소드에서는 아무것도 실시하지 않습니다.

관련 항목:

destroy() , init() , stop() , Component.isShowing() , ComponentListener.componentShown(java.awt.event.ComponentEvent)

stop

public void stop()

브라우저 또는 애플릿 viewer에 의해 불려 가 이 애플릿의 실행을 정지할 필요가 있는 것을 통지합니다. 이 메소드는, 애플릿을 포함한 Web 페이지 대신에 다른 Web 페이지가 표시되었을 때, 및 애플릿이 파기되기 직전에 불려 갑니다.

애플릿을 포함한 Web 페이지가 비표시가 될 때마다 하등의 처리를 실시하는 경우는,Applet 의 서브 클래스에서는 이 메소드를 오버라이드(override) 할 필요가 있습니다. 예를 들어, 애니메이션을 포함한 애플릿의 경우는,start 메소드로 애니메이션을 재생해,stop 메소드로 애니메이션을 정지합니다.

Applet 클래스의 이 메소드에서는 아무것도 실시하지 않습니다.

관련 항목:

destroy() , init()

destroy

public void destroy()

브라우저 또는 애플릿 viewer에 의해 불려 가 이 애플릿의 재생중에, 할당할 수 있던 모든 자원을 파기할 필요가 있는 것을 통지합니다. destoroy 메소드의 전에,stop 메소드가 반드시 불려 갑니다.

파기하기 전에 하등의 처리를 실시하는 경우는,Applet 의 서브 클래스에서는 이 메소드를 오버라이드(override) 할 필요가 있습니다. 예를 들어, thread를 사용하는 애플릿의 경우는,init 메소드로 thread를 작성해,destroy 메소드로 thread를 파기합니다.

Applet 클래스의 이 메소드에서는 아무것도 실시하지 않습니다.

관련 항목:

init() , start() , stop()

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 애플릿에 관련한 AccessibleContext 를 돌려줍니다. 애플릿의 경우, AccessibleContext 는 AccessibleApplet 의 형식을 취합니다. 필요에 따라서 신규의 AccessibleApplet 인스턴스가 작성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 Panel 내의 getAccessibleContext

반환값:

이 Applet 의 AccessibleContext 로서 기능하는 AccessibleApplet

도입된 버젼:

1.3