Класс Applet
- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- java.awt.Panel
-
- java.applet.Applet
- Все реализованные интерфейсы:
- ImageObserver, MenuContainer, Serializable, Accessible
- Прямые известные подклассы:
- JApplet
public class Applet extends Panel
Апплеты — это небольшие программы, предназначенные не для самостоятельного запуска, а для встраивания в другое приложение.
Класс Applet должен быть суперклассом любого апплета, который должен быть встроен в веб-страницу или просмотрен с помощью Java Applet Viewer. Класс Applet предоставляет стандартный интерфейс между апплетами и их окружением.
- С:
- JDK1.0
- См. также:
- Сериализованная форма
Вложенные классы
| Модификатор и тип | Класс и описание |
|---|---|
protected class |
Applet.AccessibleApplet Этот класс реализует поддержку доступности для класса |
Вложенные классы/интерфейсы, унаследованные от класса java.awt.Panel
Panel.AccessibleAWTPanel Вложенные классы/интерфейсы, унаследованные от класса java.awt.Container
Container.AccessibleAWTContainer Вложенные классы/интерфейсы, унаследованные от класса java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy Поля
Поля, унаследованные от класса java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT Поля, унаследованные от интерфейса java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH Конструкторы
| Конструктор и описание |
|---|
Applet() Создаёт новый Applet. |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
void |
destroy() Вызывается браузером или просмотрщиком апплетов, чтобы сообщить этому апплету о том, что он собирается быть удалён, и что он должен уничтожить все ресурсы, которые он выделил. |
AccessibleContext |
getAccessibleContext() Получает AccessibleContext, связанный с этим Applet. |
AppletContext |
getAppletContext() Определяет контекст этого апплета, что позволяет апплету запрашивать и влиять на среду, в которой он выполняется. |
String |
getAppletInfo() Возвращает информацию об этом апплете. |
AudioClip |
getAudioClip(URL url) Возвращает объект |
AudioClip |
getAudioClip(URL url,
String name) Возвращает объект |
URL |
getCodeBase() Получает базовый URL. |
URL |
getDocumentBase() Получает URL документа, в котором встроен этот апплет. |
Image |
getImage(URL url) Возвращает объект |
Image |
getImage(URL url,
String name) Возвращает объект |
Locale |
getLocale() Получает локаль апплета. |
String |
getParameter(String name) Возвращает значение именованного параметра в теге HTML. |
String[][] |
getParameterInfo() Возвращает информацию о параметрах, которые понимает этот апплет. |
void |
init() Вызывается браузером или просмотрщиком апплетов, чтобы сообщить этому апплету, что он загружен в систему. |
boolean |
isActive() Определяет, активен ли этот апплет. |
boolean |
isValidateRoot() Указывает, является ли этот контейнер корневым элементом валидации. |
static AudioClip |
newAudioClip(URL url) Получение аудиоклипа из указанного URL. |
void |
play(URL url) Воспроизведение аудиоклипа по указанному абсолютному URL. |
void |
play(URL url,
String name) Воспроизведение аудиоклипа, используя URL и спецификатор, относительный к нему. |
void |
resize(Dimension d) Запрос изменения размера этого апплета. |
void |
resize(int width,
int height) Запрос изменения размера этого апплета. |
void |
setStub(AppletStub stub) Устанавливает заглушку апплета. |
void |
showStatus(String msg) Запрашивает вывод указанной строки в "окне состояния" (status window). |
void |
start() Вызывается браузером или просмотрщиком апплетов, чтобы сообщить этому апплету о начале его выполнения. |
void |
stop() Вызывается браузером или просмотрщиком апплетов, чтобы сообщить этому апплету о прекращении его выполнения. |
Методы, унаследованные от класса java.awt.Panel
addNotify Методы, унаследованные от класса java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTree Методы, унаследованные от класса java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait Конструкторы
Applet
public Applet()
throws HeadlessException Создаёт новый Applet.
Примечание: многие методы в java.applet.Applet могут быть вызваны апплетом только после его полного построения; апплет должен избегать вызова методов в java.applet.Applet в конструкторе.
- Исключения:
-
HeadlessException- если GraphicsEnvironment.isHeadless() возвращает true. - С тех пор:
- 1.4
- См. также:
GraphicsEnvironment.isHeadless()
Методы
setStub
public final void setStub(AppletStub stub)
Устанавливает заглушку (stub) для этого апплета. Это выполняется автоматически системой.
Если существует менеджер безопасности, его метод checkPermission вызывается с разрешением AWTPermission("setAppletStub") , если заглушка уже установлена.
- Параметры:
-
stub- новая заглушка. - Исключения:
-
SecurityException- если вызывающий объект не может установить заглушку
isActive
public boolean isActive()
Определяет, является ли этот апплет активным. Аплет помечается как активный непосредственно перед вызовом его метода start. Он становится неактивным непосредственно перед вызовом его метода stop.
getDocumentBase
public URL getDocumentBase()
Получает URL документа, в котором вставлен этот апплет. Например, предположим, что апплет содержится в документе:
http://www.oracle.com/technetwork/java/index.htmlБазовая ссылка документа:
http://www.oracle.com/technetwork/java/index.html
- Возвращает:
- URL
URLдокумента, содержащего этот апплет. - См. также:
getCodeBase()
getCodeBase
public URL getCodeBase()
Получает базовый URL. Это URL каталога, содержащего этот апплет.
- Возвращает:
- базовый
URLкаталога, содержащего этот апплет. - См. также:
getDocumentBase()
getParameter
public String getParameter(String name)
Возвращает значение параметра с указанным именем в теге HTML. Например, если этот апплет задан как
<applet code="Clock" width=50 height=50> <param name=Color value="blue"> </applet>
то вызов getParameter("Color") вернёт значение "blue".
Аргумент name не учитывает регистр.
- Параметры:
-
name- имя параметра. - Возвращает:
- значение указанного параметра или
null, если он не задан.
getAppletContext
public AppletContext getAppletContext()
Определяет контекст этого апплета, который позволяет апплету получать информацию и влиять на среду его выполнения.
Эта среда апплета представляет документ, содержащий апплет.
- Возвращает:
- контекст апплета.
resize
public void resize(int width,
int height) Запрашивает изменение размеров этого апплета.
- Переопределяет:
-
resizeв классеComponent - Параметры:
-
width- новый запрошенный размер ширины апплета. -
height- новый запрошенный размер высоты апплета.
resize
public void resize(Dimension d)
Запрашивает изменение размеров этого апплета.
isValidateRoot
public boolean isValidateRoot()
Указывает, является ли этот контейнер корнем валидации.
Объекты Applet являются корнями валидации и, следовательно, переопределяют этот метод, чтобы вернуть true.
- Переопределяет:
-
isValidateRootв классеContainer - Возвращает:
true- С тех пор:
- 1.7
- См. также:
Container.isValidateRoot()
showStatus
public void showStatus(String msg)
Запрашивает отображение строкового аргумента в "окне состояния". Многие браузеры и просмотрщики апплетов предоставляют такое окно, где приложение может информировать пользователей о своём текущем состоянии.
- Параметры:
-
msg- строка для отображения в окне состояния.
getImage
public Image getImage(URL url)
Возвращает объект Image, который затем можно отрисовать на экране. URL, переданный в качестве аргумента, должен указывать на абсолютный URL.
Этот метод всегда возвращает результат немедленно, независимо от того, существует ли изображение. Когда этот апплет пытается нарисовать изображение на экране, данные будут загружены. Графические примитивы, рисующие изображение, будут поэтапно отрисовывать изображение на экране.
- Параметры:
-
url- абсолютный URL, указывающий на расположение изображения. - Возвращает:
- изображение по указанному URL.
- См. также:
Image
getImage
public Image getImage(URL url,
String name) Возвращает объект Image, который затем можно отрисовать на экране. Аргумент url должен указывать на абсолютный URL. Аргумент name — это спецификатор, относящийся к аргументу url.
Этот метод всегда возвращает результат немедленно, независимо от того, существует ли изображение. Когда этот апплет пытается нарисовать изображение на экране, данные будут загружены. Графические примитивы, рисующие изображение, будут поэтапно отрисовывать изображение на экране.
- Параметры:
-
url- абсолютный URL, задающий базовое расположение изображения. -
name- расположение изображения относительно аргументаurl. - Возвращает:
- изображение по указанному URL.
- См. также:
Image
newAudioClip
public static final AudioClip newAudioClip(URL url)
Получить аудиоклип по заданному URL.
- Параметры:
-
url- указывает на аудиоклип - Возвращает:
- аудиоклип по указанному URL.
- С тех пор:
- 1.2
getAudioClip
public AudioClip getAudioClip(URL url)
Возвращает объект AudioClip , указанный аргументом URL.
Этот метод всегда возвращает результат немедленно, независимо от того, существует ли аудиоклип. При попытке воспроизведения аудиоклипа апплетом данные будут загружены.
- Параметры:
-
url- абсолютный URL, указывающий на расположение аудиоклипа. - Возвращает:
- аудиоклип по указанному URL.
- См. также:
AudioClip
getAudioClip
public AudioClip getAudioClip(URL url,
String name) Возвращает объект AudioClip , указанный аргументами URL и name.
Этот метод всегда возвращает результат немедленно, независимо от того, существует ли аудиоклип. При попытке воспроизведения аудиоклипа апплетом данные будут загружены.
- Параметры:
-
url- абсолютный URL, задающий базовое расположение аудиоклипа. -
name- расположение аудиоклипа относительно аргументаurl. - Возвращает:
- аудиоклип по указанному URL.
- См. также:
AudioClip
getAppletInfo
public String getAppletInfo()
Возвращает информацию об этом апплете. Апплету следует переопределить этот метод для возврата строки, содержащей информацию об авторе, версии и авторских правах апплета.
Реализация этого метода, предоставленная классом Applet, возвращает null.
- Возвращает:
- строка, содержащая информацию об авторе, версии и авторских правах апплета.
getLocale
public Locale getLocale()
Получает локаль апплета. Это позволяет апплету поддерживать свою собственную локаль, независимо от локали браузера или просмотрщика апплетов.
- Переопределяет:
-
getLocaleв классеComponent - Возвращает:
- локаль апплета; если локаль не установлена, возвращается локаль по умолчанию.
- С тех пор:
- JDK1.1
- См. также:
Component.setLocale(java.util.Locale)
getParameterInfo
public String[][] getParameterInfo()
Возвращает информацию о параметрах, которые понимает этот апплет. Апплету следует переопределить этот метод, чтобы вернуть массив объектов, описывающих эти параметры.
Каждый элемент массива должен быть набором из трёх строк, содержащих имя, тип и описание. Например:
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)
Воспроизводит аудиоклип по указанному абсолютному URL. Ничего не происходит, если аудиоклип не найден.
- Параметры:
-
url- абсолютный URL, указывающий на расположение аудиоклипа.
play
public void play(URL url,
String name) Воспроизводит аудиоклип, используя URL и спецификатор, относящийся к нему. Ничего не происходит, если аудиоклип не найден.
- Параметры:
-
url- абсолютный URL, указывающий на базовое расположение аудиоклипа. -
name- расположение аудиоклипа относительно аргументаurl.
init
public void init()
Вызывается браузером или просмотрщиком апплетов для уведомления этого апплета о том, что он загружен в систему. Он всегда вызывается перед первым вызовом метода start.
Подкласс Applet должен переопределить этот метод, если необходимо выполнить инициализацию. Например, апплет с потоками использует метод init для создания потоков и метод destroy для их завершения.
Реализация этого метода в классе Applet ничего не делает.
start
public void start()
Вызывается браузером или просмотрщиком апплетов для уведомления этого апплета о необходимости начать выполнение. Он вызывается после метода init и каждый раз, когда апплет посещается на веб-странице.
Подкласс Applet должен переопределить этот метод, если необходимо выполнить какие-либо операции каждый раз, когда посещается веб-страница, содержащая апплет. Например, апплет с анимацией может использовать метод start для возобновления анимации и метод stop для приостановки анимации.
Примечание: некоторые методы, такие как getLocationOnScreen, могут предоставлять осмысленные результаты только если апплет отображается. Поскольку isShowing возвращает false при первом вызове start апплета, методы, требующие, чтобы isShowing возвращало true, должны вызываться из ComponentListener.
Реализация этого метода в классе Applet ничего не делает.
- См. также:
-
destroy(),init(),stop(),Component.isShowing(),ComponentListener.componentShown(java.awt.event.ComponentEvent)
stop
public void stop()
Вызывается браузером или просмотрщиком апплетов для уведомления этого апплета о необходимости остановить выполнение. Это вызывается, когда веб-страница, содержащая этот апплет, заменена другой страницей, а также непосредственно перед уничтожением апплета.
Подкласс Applet должен переопределить этот метод, если необходимо выполнить какие-либо операции каждый раз, когда веб-страница, содержащая его, больше не отображается. Например, апплет с анимацией может использовать метод start для возобновления анимации и метод stop для приостановки анимации.
Реализация этого метода в классе Applet ничего не делает.
destroy
public void destroy()
Вызывается браузером или просмотрщиком апплетов для уведомления этого апплета о том, что он должен быть удален, и что он должен уничтожить все выделенные ресурсы. Метод stop всегда вызывается до destroy.
Подкласс Applet должен переопределить этот метод, если необходимо выполнить какие-либо операции перед уничтожением. Например, апплет с потоками использует метод init для создания потоков и метод destroy для их завершения.
Реализация этого метода в классе Applet ничего не делает.
getAccessibleContext
public AccessibleContext getAccessibleContext()
Получает AccessibleContext, связанный с этим апплетом. Для апплетов AccessibleContext представлен в виде AccessibleApplet. Новый экземпляр AccessibleApplet создается при необходимости.
- Указано в:
-
getAccessibleContextв интерфейсеAccessible - Переопределяет:
-
getAccessibleContextв классеPanel - Возвращает:
- AccessibleApplet, который служит AccessibleContext этого апплета
- С:
- 1.3
© 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.