モジュール java.desktop

パッケージ java.applet

インタフェースAppletContext

@Deprecated(since="9", forRemoval=true) public interface AppletContext

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

アプレットAPIは非推奨であり、代替はありません。

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

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

導入されたバージョン:

1.0

メソッドのサマリー

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

メソッドの詳細

getAudioClip

AudioClip getAudioClip(URL url)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

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

パラメータ:

url - オーディオ・クリップのロケーションを絶対に指定するURL

戻り値:

指定されたURLのオーディオ・クリップ

getImage

Image getImage(URL url)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

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

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

パラメータ:

url - イメージのロケーションの絶対URL

戻り値:

指定されたURLのイメージ

関連項目:

• Image

getApplet

Applet getApplet(String name)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

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

パラメータ:

name - アプレットの名前

戻り値:

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

getApplets

Enumeration<Applet> getApplets()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

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

戻り値:

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

showDocument

void showDocument(URL url)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

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

パラメータ:

url - ドキュメントのロケーションを示す絶対的なURL

showDocument

void showDocument(URL url, String target)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

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

引数targetとその説明

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

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

パラメータ:

url - ドキュメントのロケーションを示す絶対的なURL

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

showStatus

void showStatus(String status)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

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

パラメータ:

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

setStream

void setStream(String key, InputStream stream) throws IOException

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

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

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

パラメータ:

key - 指定された値が関連付けられるキー

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

例外:

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

導入されたバージョン:

1.4

getStream

InputStream getStream(String key)

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

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

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

パラメータ:

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

戻り値:

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

導入されたバージョン:

1.4

getStreamKeys

Iterator<String> getStreamKeys()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

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

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

戻り値:

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

導入されたバージョン:

1.4