Интерфейс AppletContext

public interface AppletContext

Этот интерфейс соответствует среде апплета: документу, содержащему апплет, и другим апплетам в том же документе.

Методы этого интерфейса могут использоваться апплетом для получения информации о его среде.

Since:: 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`.
`void`	`showDocument(URL url, String target)` Запрашивает у браузера или просмотрщика апплетов отображение веб-страницы, указанной аргументом `url`.
`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. Браузер или просмотрщик апплетов определяет, какое окно или фрейм отобразить веб-страницу. Этот метод может быть проигнорирован контекстами апплетов, которые не являются браузерами.

Параметры:: url - абсолютный URL, указывающий расположение документа.

showDocument

void showDocument(URL url,
                  String target)

Запрашивает у браузера или просмотрщика апплетов отображение веб-страницы, указанной аргументом url. Аргумент target указывает, в каком фрейме HTML документ должен быть отображен. Аргумент целевого фрейма интерпретируется следующим образом:

Аргумент целевого фрейма	Описание
`"_self"`	Отобразить в окне и фрейме, содержащем апплет.
`"_parent"`	Отобразить во фрейме-родителе апплета. Если у фрейма апплета нет фрейма-родителя, действует так же, как "_self".
`"_top"`	Отобразить в верхнем фрейме окна апплета. Если фрейм апплета является верхним фреймом, действует так же, как "_self".
`"_blank"`	Отобразить в новом, неопределённом верхнем окне.
имя	Отобразить во фрейме или окне с именем имя. Если целевой фрейм или окно с именем имя не существует, создаётся новое верхнее окно со специфицированным именем, и документ отображается там.

Просмотрщик апплетов или браузер могут игнорировать showDocument.

Параметры:: url - абсолютный URL, указывающий расположение документа.; target - String указывающий, где отобразить страницу.

showStatus

void showStatus(String status)

Запрашивает отображение строки аргумента в «окне состояния». Многие браузеры и просмотрщики апплетов предоставляют такое окно, где приложение может информировать пользователей о своём текущем состоянии.

Параметры:: status - строка для отображения в окне состояния.

setStream

void setStream(String key,
               InputStream stream)
        throws IOException

Сопоставляет указанный поток с указанным ключом в этом контексте апплета. Если контекст апплета ранее содержал отображение для этого ключа, старое значение заменяется.

По соображениям безопасности, отображение потоков и ключей существует для каждого кодовой базы. Другими словами, апплет из одной кодовой базы не может получить доступ к потокам, созданным апплетом из другой кодовой базы.

Параметры:: key - ключ, с которым должно быть сопоставлено указанное значение.; stream - поток, который нужно сопоставить с указанным ключом. Если этот параметр null, указанный ключ удаляется в этом контексте апплета.
Исключения:: IOException - если размер потока превышает определённый размер. Предел размера определяется разработчиком этого интерфейса.
Since:: 1.4

getStream

InputStream getStream(String key)

Возвращает поток, которому в рамках этого контекста апплета сопоставлен указанный ключ. Возвращает null, если контекст апплета не содержит потока для этого ключа.

Параметры:: key - ключ, ассоциированный поток которого должен быть возвращён.
Возвращает:: поток, которому этот контекст апплета сопоставляет ключ
Since:: 1.4

getStreamKeys

Iterator<String> getStreamKeys()

Находит все ключи потоков в этом контексте апплета.

Возвращает:: итератор всех имён потоков в этом контексте апплета.
Since:: 1.4

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.