java.applet

インタフェースAppletContext

public interface AppletContext

このインタフェースはアプレットの環境に対応します。アプレットの環境とは、アプレットを含むドキュメント、および同じドキュメント内にあるほかのアプレットのことです。

このインタフェースのメソッドをアプレット内で使用すると、そのアプレットの環境についての情報を取得できます。

導入されたバージョン:

JDK1.0

メソッドのサマリー

修飾子と型	メソッドと説明
Applet	getApplet(String name) このアプレット・コンテキストによって表現されるドキュメント内で、指定された名前のアプレットを探して返します。
Enumeration<Applet>	getApplets() このアプレット・コンテキストによって表現されるドキュメント内にあるすべてのアプレットを探します。
AudioClip	getAudioClip(URL url) オーディオ・クリップを作成します。
Image	getImage(URL url) あとで画面上にペイントできるImageオブジェクトを返します。
InputStream	getStream(String key) このアプレット・コンテキスト内に関連付けられているキーへのストリームを返します。
Iterator<String>	getStreamKeys() このアプレット・コンテキスト内のストリームのキーをすべて検索します。
void	setStream(String key, InputStream stream) 指定されたストリームをこのアプレット・コンテキストの指定されたキーに関連付けます。
void	showDocument(URL url) ブラウザまたはアプレット・ビューアに、引数urlに指定されたWebページを表示するように要求します。
void	showDocument(URL url, String target) ブラウザまたはアプレット・ビューアに、引数urlに指定されたWebページを表示するように要求します。
void	showStatus(String status) 引数に指定された文字列を「ステータス・ウィンドウ」に表示するように要求します。

メソッドの詳細

getAudioClip

AudioClip getAudioClip(URL url)

オーディオ・クリップを作成します。

パラメータ:

url - オーディオ・クリップの位置を示す絶対URL。

戻り値:

指定されたURLにあるオーディオ・クリップ

getImage

Image getImage(URL url)

あとで画面上にペイントできるImageオブジェクトを返します。引数urlには、絶対URLを指定する必要があります。

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

パラメータ:

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

戻り値:

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

関連項目:

Image

getApplet

Applet getApplet(String name)

このアプレット・コンテキストによって表現されるドキュメント内で、指定された名前のアプレットを探して返します。アプレット名は、HTMLタグのname属性を使って指定できます。

パラメータ:

name - アプレットの名前

戻り値:

指定された名前のアプレット。アプレットが見つからない場合はnull

getApplets

Enumeration<Applet> getApplets()

このアプレット・コンテキストによって表現されるドキュメント内にあるすべてのアプレットを探します。

戻り値:

このアプレット・コンテキストによって表現されるドキュメント内にあるすべてのアプレットの列挙

showDocument

void showDocument(URL url)

ブラウザまたはアプレット・ビューアに、引数urlに指定されたWebページを表示するように要求します。ブラウザまたはアプレット・ビューアは、Webページを表示するウィンドウまたはフレームを決定します。アプレット・コンテキストがブラウザでない場合は、このメソッドは無視されます。

パラメータ:

url - ドキュメントの位置を示す絶対URL。

showDocument

void showDocument(URL url,
                  String target)

ブラウザまたはアプレット・ビューアに、引数urlに指定されたWebページを表示するように要求します。引数targetには、ドキュメントを表示するHTMLフレームを指定します。引数targetは次のように解釈されます。

引数target	説明
"_self"	アプレットを含むウィンドウおよびフレームに表示する
"_parent"	アプレットの親フレームに表示する。親フレームがない場合は"_self"と同じ
"_top"	アプレットのウィンドウの最上位フレームに表示する。アプレットのフレームが最上位フレームの場合は"_self"と同じ
"_blank"	名前のない新しい最上位ウィンドウに表示する
name	nameに名前を指定したフレームまたはウィンドウに表示する。nameに指定したターゲットがまだない場合は、指定した名前で新しい最上位ウィンドウが作成され、そこにドキュメントが表示される

showDocumentメソッドは、アプレット・ビューアやブラウザによっては無視されることがあります。

パラメータ:

url - ドキュメントの位置を示す絶対URL。

target - ページを表示する場所を示すString

showStatus

void showStatus(String status)

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

パラメータ:

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

setStream

void setStream(String key,
               InputStream stream)
        throws IOException

指定されたストリームをこのアプレット・コンテキストの指定されたキーに関連付けます。アプレット・コンテキストが以前にこのキーのマッピングを保持していた場合、古い値が置き換えられます。

セキュリティ上の理由から、ストリームおよびキーのマッピングはコード・ベースごとに行います。つまり、あるコード・ベースのアプレットは、ほかのコード・ベースのアプレットによって作成されたストリームにアクセスできません。

パラメータ:

key - 指定の値が関連付けられるキー。

stream - 指定されたキーに関連付けられたストリーム。パラメータがnullの場合は、該当するアプレット・コンテキストから指定されたキーが削除される。

例外:

IOException - ストリームのサイズが指定のサイズ制限を超えた場合。サイズ制限は、このインタフェースの実装者が決定する。

導入されたバージョン:

1.4

getStream

InputStream getStream(String key)

このアプレット・コンテキスト内に関連付けられているキーへのストリームを返します。対象のアプレットにキーのストリームが含まれていない場合は、nullが返されます。

セキュリティ上の理由から、ストリームおよびキーのマッピングはコード・ベースごとに行います。つまり、あるコード・ベースのアプレットは、ほかのコード・ベースのアプレットによって作成されたストリームにアクセスできません。

パラメータ:

key - 関連付けられているストリームが返されるキー

戻り値:

このアプレット・コンテキストがマッピングしたキーへのストリーム

導入されたバージョン:

1.4

getStreamKeys

Iterator<String> getStreamKeys()

このアプレット・コンテキスト内のストリームのキーをすべて検索します。

セキュリティ上の理由から、ストリームおよびキーのマッピングはコード・ベースごとに行います。つまり、あるコード・ベースのアプレットは、ほかのコード・ベースのアプレットによって作成されたストリームにアクセスできません。

戻り値:

このアプレット・コンテキスト内のストリーム名すべてのイテレータ

導入されたバージョン:

1.4