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 アプレットビューアで表示されるアプレットのスーパークラスです。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() ブラウザまたはアプレットビューアによって呼び出され、このアプレットの再生中に、割り当てられたすべてのリソースを破棄する必要があることを通知します。
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() ブラウザまたはアプレットビューアによって呼び出され、このアプレットがシステムにロードされたことを通知します。
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) アプレットのスタブを設定します。
void	showStatus(String msg) 引数に指定された文字列を「ステータスウィンドウ」に表示するように要求します。
void	start() ブラウザまたはアプレットビューアによって呼び出され、このアプレットの実行を開始する必要があることを通知します。
void	stop() ブラウザまたはアプレットビューアによって呼び出され、このアプレットの実行を停止する必要があることを通知します。

クラス 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)

アプレットのスタブを設定します。この処理は、システムによって自動的に行われます。

セキュリティーマネージャーが存在する場合は、スタブがすでに設定されていると、AWTPermission("setAppletStub") アクセス権によって checkPermission メソッドを呼び出します。

パラメータ:

stub - 新しいスタブ

例外:

SecurityException - 呼び出し側がスタブを設定できない場合

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)

アプレットのサイズ変更を要求します。

オーバーライド:

クラス Component 内の resize

パラメータ:

width - アプレットに新しく要求された幅

height - アプレットに新しく要求された高さ

resize

public void resize(Dimension d)

アプレットのサイズ変更を要求します。

オーバーライド:

クラス Component 内の resize

パラメータ:

d - 新しい幅と高さを示すオブジェクト

showStatus

public void showStatus(String msg)

引数に指定された文字列を「ステータスウィンドウ」に表示するように要求します。多くのブラウザやアプレットビューアにはステータスウィンドウがあり、アプリケーションはこのウィンドウを使用してユーザーに現在の状態を伝えることができます。

パラメータ:

msg - ステータスウィンドウに表示される文字列

getImage

public Image getImage(URL url)

Image オブジェクトを返します。このオブジェクトは、画面に描画することができます。引数 url には、絶対 URL を指定します。

このメソッドは、イメージがあるかどうかにかかわらず、すぐに復帰します。アプレットが画面にイメージを描画しようとしたときに、データがロードされます。イメージは少しずつ画面に描画されていきます。

パラメータ:

url - イメージの位置を示す絶対 URL

戻り値:

指定された URL にあるイメージ

関連項目:

Image

getImage

public Image getImage(URL url,
                      String name)

Image オブジェクトを返します。このオブジェクトは、画面に描画することができます。引数 url には絶対 URL を指定します。引数 name には、引数 url との相対位置を指定します。

このメソッドは、イメージがあるかどうかにかかわらず、すぐに復帰します。アプレットが画面にイメージを描画しようとしたときに、データがロードされます。イメージは少しずつ画面に描画されていきます。

パラメータ:

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()

アプレットについての情報を返します。アプレットは、このメソッドをオーバーライドして、アプレットの作成者、バージョン、および著作権についての情報を含む String オブジェクトを返します。

Applet クラスのこのメソッドの実装は、null を返します。

戻り値:

アプレットの作成者、バージョン、および著作権についての情報を含む文字列

getLocale

public Locale getLocale()

アプレットのロケールを取得します。アプレットは、ブラウザまたはアプレットビューアのロケールから独立した、独自のロケールを保持できます。

オーバーライド:

クラス Component 内の getLocale

戻り値:

アプレットのロケール。ロケールが設定されていない場合は、デフォルトのロケールを返す

導入されたバージョン:

JDK1.1

関連項目:

Component.setLocale(java.util.Locale)

getParameterInfo

public String[][] getParameterInfo()

このアプレットが解釈するパラメータについての情報を返します。アプレットは、このメソッドをオーバーライドして、これらのパラメータについての情報を含む 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()

ブラウザまたはアプレットビューアによって呼び出され、このアプレットがシステムにロードされたことを通知します。このメソッドは、start メソッドが最初に呼び出される前に常に呼び出されます。

Applet のサブクラスで初期化処理を行う場合は、このメソッドをオーバーライドする必要があります。たとえば、スレッドを使用するアプレットの場合は、init メソッドでスレッドを作成し、destroy メソッドでスレッドを破棄します。

Applet クラスのこのメソッドでは何も行いません。

関連項目:

destroy(), start(), stop()

start

public void start()

ブラウザまたはアプレットビューアによって呼び出され、このアプレットの実行を開始する必要があることを通知します。このメソッドは、init メソッドのあとに呼び出され、Web ページ上でアプレットがアクティブになるたびに呼び出されます。

アプレットを含む Web ページが表示されるたびになんらかの処理を行う場合は、Applet のサブクラスではこのメソッドをオーバーライドする必要があります。たとえば、アニメーションを含むアプレットの場合は、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()

ブラウザまたはアプレットビューアによって呼び出され、このアプレットの実行を停止する必要があることを通知します。このメソッドは、アプレットを含む Web ページの代わりに別の Web ページが表示されたとき、およびアプレットが破棄される直前に呼び出されます。

アプレットを含む Web ページが非表示になるたびになんらかの処理を行う場合は、Applet のサブクラスではこのメソッドをオーバーライドする必要があります。たとえば、アニメーションを含むアプレットの場合は、start メソッドでアニメーションを再生し、stop メソッドでアニメーションを停止します。

Applet クラスのこのメソッドでは何も行いません。

関連項目:

destroy(), init()

destroy

public void destroy()

ブラウザまたはアプレットビューアによって呼び出され、このアプレットの再生中に、割り当てられたすべてのリソースを破棄する必要があることを通知します。destoroy メソッドの前に、stop メソッドが必ず呼び出されます。

破棄する前になんらかの処理を行う場合は、Applet のサブクラスではこのメソッドをオーバーライドする必要があります。たとえば、スレッドを使用するアプレットの場合は、init メソッドでスレッドを作成し、destroy メソッドでスレッドを破棄します。

Applet クラスのこのメソッドでは何も行いません。

関連項目:

init(), start(), stop()

getAccessibleContext

public AccessibleContext getAccessibleContext()

このアプレットに関連した AccessibleContext を返します。アプレットの場合、AccessibleContext は AccessibleApplet の形式を取ります。必要に応じて新規の AccessibleApplet インスタンスが作成されます。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス Panel 内の getAccessibleContext

戻り値:

この Applet の AccessibleContext として機能する AccessibleApplet

導入されたバージョン:

1.3