Spec-Zone.ru › OpenJDK 8

Класс 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

Этот класс реализует поддержку доступности для класса Applet.

Вложенные классы/интерфейсы, унаследованные от класса 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, указанный аргументом URL.

AudioClip getAudioClip(URL url, String name)

Возвращает объект AudioClip, указанный аргументами URL и name.

URL getCodeBase()

Получает базовый URL.

URL getDocumentBase()

Получает URL документа, в котором встроен этот апплет.

Image getImage(URL url)

Возвращает объект Image, который затем можно нарисовать на экране.

Image getImage(URL url, String name)

Возвращает объект Image, который затем можно нарисовать на экране.

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.

Возвращает:
true , если апплет активен; false в противном случае.
См. также:
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)

Запрашивает изменение размеров этого апплета.

Переопределяет:
resize в классе Component
Параметры:
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 ничего не делает.

См. также:
destroy(), start(), stop()

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(), init()

destroy

public void destroy()

Вызывается браузером или просмотрщиком апплетов для уведомления этого апплета о том, что он должен быть удален, и что он должен уничтожить все выделенные ресурсы. Метод stop всегда вызывается до destroy.

Подкласс Applet должен переопределить этот метод, если необходимо выполнить какие-либо операции перед уничтожением. Например, апплет с потоками использует метод init для создания потоков и метод destroy для их завершения.

Реализация этого метода в классе Applet ничего не делает.

См. также:
init(), start(), stop()

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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API