モジュール java.desktop
パッケージ java.applet

クラスApplet

java.lang.Object
java.awt.Component
java.awt.Container
java.awt.Panel
java.applet.Applet
すべての実装されたインタフェース:
ImageObserver, MenuContainer, Serializable, Accessible
直系の既知のサブクラス:
JApplet
@Deprecated(since="9")
public class Applet
extends Panel
Deprecated.
アプレットAPIは非推奨であり、代替はありません。
アプレットとは、単独で動作することはなく、ほかのアプリケーションの中に組み込まれた形で実行される小さなプログラムです。

Appletクラスは、Webページに埋め込まれるアプレット、またはJavaアプレット・ビューアで表示されるアプレットのスーパー・クラスです。 Appletクラスは、アプレットとその環境との間の標準インタフェースの役割を果たします。

導入されたバージョン:
1.0
関連項目:
直列化された形式

  • コンストラクタの詳細

    • Applet

      public Applet() throws HeadlessException
      Deprecated.
      新しいAppletを構築します。

      ノート: java.applet.Appletの多くのメソッドは、アプレットが完全に構築されてからそのアプレットによって呼び出すことができます。コンストラクタ内でjava.applet.Appletのメソッドを呼び出さないようにしてください。

      例外:
      HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返す場合
      導入されたバージョン:
      1.4
      関連項目:
      GraphicsEnvironment.isHeadless()

  • メソッドの詳細

    • setStub

      public final void setStub​(AppletStub stub)
      Deprecated.
      アプレットのスタブを設定します。 この処理は、システムによって自動的に行われます。

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

      パラメータ:
      stub - 新しいスタブ
      例外:
      SecurityException - 呼出し側がスタブを設定できない場合

    • isActive

      public boolean isActive()
      Deprecated.
      アプレットがアクティブかどうかを判定します。 アプレットは、startメソッドが呼び出される直前にアクティブになり、 stopメソッドが呼び出される直前にアクティブでなくなります。
      戻り値:
      アプレットがアクティブな場合はtrue、そうでない場合はfalse
      関連項目:
      start(), stop()

    • getDocumentBase

      public URL getDocumentBase()
      Deprecated.
      このアプレットが埋め込まれているドキュメントのURLを取得します。 たとえば、次のドキュメント内にアプレットが含まれているとします。 
          http://www.oracle.com/technetwork/java/index.html
      ドキュメントのベースは次のとおりです。 
          http://www.oracle.com/technetwork/java/index.html
      戻り値:
      このアプレットを含むドキュメントのURL
      関連項目:
      getCodeBase()

    • getCodeBase

      public URL getCodeBase()
      Deprecated.
      ベースURLを取得します。 これは、このアプレットが含まれているディレクトリのURLです。
      戻り値:
      このアプレットを含むディレクトリのベースURL
      関連項目:
      getDocumentBase()

    • getParameter

      public String getParameter​(String name)
      Deprecated.
      HTMLタグ内にある指定されたパラメータの値を返します。 たとえば、アプレットが次のように指定されているとします。 
       <applet code="Clock" width=50 height=50>
 <param name=Color value="blue">
 </applet>

      この場合、getParameter("Color")の呼出しは、値"blue"を返します。

      引数nameでは大文字と小文字を区別しません。

      パラメータ:
      name - パラメータ名
      戻り値:
      指定されたパラメータの値。設定されていない場合はnull

    • getAppletContext

      public AppletContext getAppletContext()
      Deprecated.
      アプレットのコンテキストを取得します。アプレットは、コンテキストを使用してアプレットの実行環境に関する情報を得たり、実行環境を制御したりできます。

      アプレットの環境は、アプレットを含んでいるドキュメントを表します。

      戻り値:
      アプレットのコンテキスト

    • resize

      public void resize​(int width, int height)
      Deprecated.
      アプレットのサイズ変更を要求します。
      オーバーライド:
      resize、クラス: Component
      パラメータ:
      width - アプレットに新しく要求された幅
      height - アプレットに新しく要求された高さ

    • resize

      public void resize​(Dimension d)
      Deprecated.
      アプレットのサイズ変更を要求します。
      オーバーライド:
      resize、クラス: Component
      パラメータ:
      d - 新しい幅と高さを示すオブジェクト

    • isValidateRoot

      public boolean isValidateRoot()
      Deprecated.
      このコンテナが有効なルートであるかどうかを示します。

      Appletオブジェクトは有効なルートであるため、それらはこのメソッドをオーバーライドしてtrueを返します。

      オーバーライド:
      isValidateRoot 、クラス:  Container
      戻り値:
      true
      導入されたバージョン:
      1.7
      関連項目:
      Container.isValidateRoot()

    • showStatus

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

    • getImage

      public Image getImage​(URL url)
      Deprecated.
      あとで画面上にペイントできるImageオブジェクトを返します。 引数として渡されるurlは、絶対URLを指定する必要があります。

      このメソッドは、イメージがあるかどうかにかかわらず、すぐに復帰します。 アプレットが画面にイメージを描画しようとしたときに、データがロードされます。 イメージを描画するグラフィックス・プリミティブは、少しずつ画面にペイントされていきます。

      パラメータ:
      url - イメージのロケーションの絶対URL
      戻り値:
      指定されたURLのイメージ
      関連項目:
      Image

    • getImage

      public Image getImage​(URL url, String name)
      Deprecated.
      あとで画面上にペイントできるImageオブジェクトを返します。 url引数では、絶対URLを指定する必要があります。 引数nameは、引数urlに関連する指定子です。

      このメソッドは、イメージがあるかどうかにかかわらず、すぐに復帰します。 アプレットが画面にイメージを描画しようとしたときに、データがロードされます。 イメージを描画するグラフィックス・プリミティブは、少しずつ画面にペイントされていきます。

      パラメータ:
      url - イメージのベース位置を示す絶対URL
      name - 引数urlに関連する、イメージの位置
      戻り値:
      指定されたURLのイメージ
      関連項目:
      Image

    • newAudioClip

      public static final AudioClip newAudioClip​(URL url)
      Deprecated.
      指定されたURLからオーディオ・クリップを取得します。
      パラメータ:
      url - オーディオ・クリップの位置
      戻り値:
      指定されたURLのオーディオ・クリップ
      導入されたバージョン:
      1.2

    • getAudioClip

      public AudioClip getAudioClip​(URL url)
      Deprecated.
      URL引数によって指定されたAudioClipオブジェクトを返します。

      このメソッドは、オーディオ・クリップがあるかどうかにかかわらず、すぐに復帰します。 アプレットがオーディオ・クリップを再生しようとしたときに、データがロードされます。

      パラメータ:
      url - オーディオ・クリップのロケーションを絶対に指定するURL
      戻り値:
      指定されたURLのオーディオ・クリップ
      関連項目:
      AudioClip

    • getAudioClip

      public AudioClip getAudioClip​(URL url, String name)
      Deprecated.
      URL引数とname引数によって指定されたAudioClipオブジェクトを返します。

      このメソッドは、オーディオ・クリップがあるかどうかにかかわらず、すぐに復帰します。 アプレットがオーディオ・クリップを再生しようとしたときに、データがロードされます。

      パラメータ:
      url - オーディオ・クリップの基本的なロケーションを指定する絶対URL
      name - 引数urlに関連する、オーディオ・クリップの位置
      戻り値:
      指定されたURLのオーディオ・クリップ
      関連項目:
      AudioClip

    • getAppletInfo

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

      Appletクラスで提供されるこのメソッドの実装は、nullを返します。

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

    • getLocale

      public Locale getLocale()
      Deprecated.
      アプレットのロケールを取得します。 アプレットは、ブラウザまたはアプレット・ビューアのロケールから独立した、独自のロケールを保持できます。
      オーバーライド:
      getLocale、クラス: Component
      戻り値:
      アプレットのロケール。ロケールが設定されていない場合は、デフォルトのロケールを返す
      導入されたバージョン:
      1.1
      関連項目:
      Component.setLocale(java.util.Locale)

    • getParameterInfo

      public String[][] getParameterInfo()
      Deprecated.
      このアプレットが解釈するパラメータについての情報を返します。 アプレットは、このメソッドをオーバーライドして、これらのパラメータを記述する文字列の配列を返す必要があります。

      配列の各要素は、名前、型および説明を含む3つの文字列のセットである必要があります。 次に例を示します。 

       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)
      Deprecated.
      指定された絶対URLにオーディオ・クリップを入れます。 オーディオ・クリップが見つからない場合は何も行いません。
      パラメータ:
      url - オーディオ・クリップのロケーションを絶対に指定するURL

    • play

      public void play​(URL url, String name)
      Deprecated.
      URLとそれに相対的な指定子が与えられているオーディオ・クリップを再生します。 オーディオ・クリップが見つからない場合は何も行いません。
      パラメータ:
      url - オーディオ・クリップの基本的なロケーションを指定する絶対URL
      name - 引数urlに関連する、オーディオ・クリップの位置

    • init

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

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

      Appletクラスで提供されるこのメソッドの実装では何も行いません。

      関連項目:
      destroy(), start(), stop()

    • start

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

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

      ノート: getLocationOnScreenなどのメソッドのいくつかは、アプレットが表示されている場合しか意味のある結果を提供できません。 アプレットのstartが最初に呼び出されたとき、isShowingはfalseを返すので、isShowingからtrueが返ることを必要とするメソッドは、ComponentListenerから呼び出す必要があります。

      Appletクラスで提供されるこのメソッドの実装では何も行いません。

      関連項目:
      destroy(), init(), stop(), Component.isShowing(), ComponentListener.componentShown(ComponentEvent)

    • stop

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

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

      Appletクラスで提供されるこのメソッドの実装では何も行いません。

      関連項目:
      destroy(), init()

    • destroy

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

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

      Appletクラスで提供されるこのメソッドの実装では何も行いません。

      関連項目:
      init(), start(), stop()

    • getAccessibleContext

      public AccessibleContext getAccessibleContext()
      Deprecated.
      このAppletに関連付けられたAccessibleContextを取得します。 アプレットの場合、AccessibleContextはAccessibleAppletの形式を取ります。 必要に応じて、新しいAccessibleAppletインスタンスが作成されます。
      定義:
      getAccessibleContext、インタフェース: Accessible
      オーバーライド:
      getAccessibleContext、クラス: Panel
      戻り値:
      このAppletのAccessibleContextとしての役割を果たすAccessibleApplet
      導入されたバージョン:
      1.3