Интерфейс AppletContext
@Deprecated(since="9") public interface AppletContext
Этот интерфейс соответствует среде апплета: документу, содержащему апплет, и другим апплетам в том же документе.
Методы этого интерфейса могут использоваться апплетом для получения информации о его среде.
- С момента:
- 1.0
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
Applet | getApplet(String name) | Устаревшее. Находит и возвращает апплет в документе, представленном этим контекстом апплета, с заданным именем. |
Enumeration<Applet> | getApplets() | Устаревшее. Находит все апплеты в документе, представленном этим контекстом апплета. |
AudioClip | getAudioClip(URL url) | Устаревшее. Создаёт звуковой клип. |
Image | getImage(URL url) | Устаревшее. Возвращает объект |
InputStream | getStream(String key) | Устаревшее. Возвращает поток, которому в этом контексте апплета соответствует указанный ключ. |
Iterator<String> | getStreamKeys() | Устаревшее. Находит все ключи потоков в этом контексте апплета. |
void | setStream(String key,
InputStream stream) | Устаревшее. Связывает указанный поток с указанным ключом в этом контексте апплета. |
void | showDocument(URL url) | Устаревшее. Запрашивает отображение браузером или просмотрщиком апплетов веб-страницы, указанной аргументом |
void | showDocument(URL url,
String target) | Устаревшее. Запрашивает отображение браузером или просмотрщиком апплетов веб-страницы, указанной аргументом |
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 должен быть отображен документ. Аргумент target интерпретируется следующим образом:
| Аргумент target | Описание |
|---|---|
"_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- если размер потока превышает определённый лимит. Лимит размера определяется реализацией этого интерфейса. - С момента:
- 1.4
getStream
InputStream getStream(String key)
Возвращает поток, которому в этом контексте апплета соответствует указанный ключ. Возвращает null, если в контексте апплета нет потока для данного ключа.
По соображениям безопасности, отображение потоков и ключей существует для каждого набора кода. Другими словами, апплет из одного набора кода не может получить доступ к потокам, созданным апплетом из другого набора кода.
- Параметры:
-
key- ключ, связанный поток которого должен быть возвращён. - Возвращает:
- поток, которому этот контекст апплета сопоставляет ключ
- С момента:
- 1.4
getStreamKeys
Iterator<String> getStreamKeys()
Находит все ключи потоков в этом контексте апплета.
По соображениям безопасности, отображение потоков и ключей существует для каждого набора кода. Другими словами, апплет из одного набора кода не может получить доступ к потокам, созданным апплетом из другого набора кода.
- Возвращает:
- итератор всех имён потоков в этом контексте апплета.
- С момента:
- 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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/java/applet/AppletContext.html