Класс JApplet

public class JApplet
extends Applet
implements Accessible, RootPaneContainer

Расширенный вариант java.applet.Applet, добавляющий поддержку архитектуры компонентов JFC/Swing. Вы можете найти документацию по использованию JApplet в руководстве по Java, в разделе Как создать апплеты.

Класс JApplet немного несовместим с java.applet.Applet. JApplet содержит JRootPane в качестве единственного дочернего элемента. contentPane должен быть родителем любых дочерних элементов JApplet. Для удобства методы add, remove, и setLayout данного класса переопределены так, чтобы делегировать вызовы соответствующим методам ContentPane. Например, вы можете добавить дочерний компонент к апплету следующим образом:

applet.add(child);

А дочерний элемент будет добавлен в contentPane. Свойство contentPane всегда будет не-null. Попытка установить его в null приведёт к тому, что JApplet выбросит исключение. У по умолчанию contentPane будет иметь установленный менеджер BorderLayout. Для получения подробной информации о добавлении, удалении и установке LayoutManager для JApplet, обратитесь к RootPaneContainer.

Полное описание свойств contentPane, glassPane, и layeredPane см. в документации JRootPane.

Предупреждение: Swing не потокобезопасен. Дополнительную информацию см. в Политике потоков Swing.

Предупреждение: Сериализованные объекты данного класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, поддержка долгосрочного хранения всех JavaBeans™ добавлена в пакет java.beans . Подробности см. в XMLEncoder.

Поля

rootPane

protected JRootPane rootPane

См. также:

getRootPane(), setRootPane(javax.swing.JRootPane)

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

Если значение true, то вызовы add и setLayout будут перенаправлены на contentPane. По умолчанию это false, но устанавливается в true при создании JApplet.

См. также:

isRootPaneCheckingEnabled(), setRootPaneCheckingEnabled(boolean), RootPaneContainer

accessibleContext

protected AccessibleContext accessibleContext

Конструкторы

JApplet

public JApplet()
        throws HeadlessException

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

Методы

createRootPane

protected JRootPane createRootPane()

Вызывается методами конструктора для создания rootPane по умолчанию.

setTransferHandler

public void setTransferHandler(TransferHandler newHandler)

Параметры:

newHandler - новое значение TransferHandler

С:

1.6

См. также:

TransferHandler, getTransferHandler(), Component.setDropTarget(java.awt.dnd.DropTarget)

getTransferHandler

public TransferHandler getTransferHandler()

Возвращает свойство transferHandler.

Возвращает:

значение свойства transferHandler

С:

1.6

См. также:

TransferHandler, setTransferHandler(javax.swing.TransferHandler)

update

public void update(Graphics g)

Просто вызывает paint(g). Этот метод был переопределён для предотвращения ненужного вызова очистки фона.

Переопределяет:

update в классе Container

Параметры:

g - указанное графическое окно

См. также:

Component.update(Graphics)

setJMenuBar

public void setJMenuBar(JMenuBar menuBar)

Устанавливает панель меню для этого апплета.

Параметры:

menuBar - панель меню, размещаемая в апплете

См. также:

getJMenuBar()

getJMenuBar

public JMenuBar getJMenuBar()

Возвращает панель меню, установленную для этого апплета.

См. также:

setJMenuBar(javax.swing.JMenuBar)

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

Возвращает значение, указывающее, перенаправляются ли вызовы add и setLayout в contentPane.

Возвращает:

true, если add и setLayout перенаправляются; false в противном случае

См. также:

addImpl(java.awt.Component, java.lang.Object, int), setLayout(java.awt.LayoutManager), setRootPaneCheckingEnabled(boolean), RootPaneContainer

setRootPaneCheckingEnabled

protected void setRootPaneCheckingEnabled(boolean enabled)

Устанавливает, перенаправляются ли вызовы add и setLayout на contentPane.

Параметры:

enabled - true, если add и setLayout перенаправляются, false — если они должны работать напрямую с JApplet.

См. также:

addImpl(java.awt.Component, java.lang.Object, int), setLayout(java.awt.LayoutManager), isRootPaneCheckingEnabled(), RootPaneContainer

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)

Добавляет указанного дочернего Component Этот метод переопределён, чтобы условно перенаправлять вызовы на contentPane. По умолчанию дети добавляются в contentPane вместо фрейма. Подробности см. в RootPaneContainer.

Переопределяет:

addImpl в классе Container

Параметры:

comp - компонент для улучшения

constraints - ограничения, которые должны соблюдаться

index - индекс

Исключения:

IllegalArgumentException - если index недопустимо

IllegalArgumentException - если родитель контейнера добавляется в себя

IllegalArgumentException - если окно добавляется в контейнер

См. также:

setRootPaneCheckingEnabled(boolean), RootPaneContainer

remove

public void remove(Component comp)

Удаляет указанный компонент из контейнера. Если comp не является rootPane, вызов будет перенаправлен на contentPane. Если comp не является потомком JFrame или contentPane, ничего не произойдёт.

Переопределяет:

remove в классе Container

Параметры:

comp - компонент для удаления

Исключения:

NullPointerException - если comp равно null

См. также:

Container.add(java.awt.Component), RootPaneContainer

setLayout

public void setLayout(LayoutManager manager)

Устанавливает LayoutManager. Переопределено для условного перенаправления вызова на contentPane. Дополнительную информацию см. в RootPaneContainer.

Переопределяет:

setLayout в классе Container

Параметры:

manager - LayoutManager

См. также:

setRootPaneCheckingEnabled(boolean), RootPaneContainer

getRootPane

public JRootPane getRootPane()

Возвращает объект rootPane для этого апплета.

Определено в:

getRootPane в интерфейсе RootPaneContainer

Возвращает:

единственный дочерний компонент JRootPane этого компонента.

См. также:

setRootPane(javax.swing.JRootPane), RootPaneContainer.getRootPane()

setRootPane

protected void setRootPane(JRootPane root)

Устанавливает свойство rootPane. Этот метод вызывается конструктором.

Параметры:

root - объект rootPane для этого апплета

См. также:

getRootPane()

getContentPane

public Container getContentPane()

Возвращает объект contentPane для этого апплета.

Определено в:

getContentPane в интерфейсе RootPaneContainer

Возвращает:

значение свойства contentPane.

См. также:

setContentPane(java.awt.Container), RootPaneContainer.getContentPane()

setContentPane

public void setContentPane(Container contentPane)

Устанавливает свойство contentPane. Этот метод вызывается конструктором.

Определено в:

setContentPane в интерфейсе RootPaneContainer

Параметры:

contentPane - объект contentPane для этого апплета

Исключения:

IllegalComponentStateException - (исключение времени выполнения) если параметр contentPane равен null

См. также:

getContentPane(), RootPaneContainer.setContentPane(java.awt.Container)

getLayeredPane

public JLayeredPane getLayeredPane()

Возвращает объект layeredPane для этого апплета.

Определено в:

getLayeredPane в интерфейсе RootPaneContainer

Возвращает:

значение свойства layeredPane.

Исключения:

IllegalComponentStateException - (исключение времени выполнения) если параметр layeredPane равен null

См. также:

setLayeredPane(javax.swing.JLayeredPane), RootPaneContainer.getLayeredPane()

setLayeredPane

public void setLayeredPane(JLayeredPane layeredPane)

Устанавливает свойство layeredPane. Этот метод вызывается конструктором.

Указано:

setLayeredPane в интерфейсе RootPaneContainer

Параметры:

layeredPane - объект layeredPane для этого апплета

См. также:

getLayeredPane(), RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)

getGlassPane

public Component getGlassPane()

Возвращает объект glassPane для этого апплета.

Указано:

getGlassPane в интерфейсе RootPaneContainer

Возвращает:

значение свойства glassPane.

См. также:

setGlassPane(java.awt.Component), RootPaneContainer.getGlassPane()

setGlassPane

public void setGlassPane(Component glassPane)

Устанавливает свойство glassPane. Этот метод вызывается конструктором.

Указано:

setGlassPane в интерфейсе RootPaneContainer

Параметры:

glassPane - объект glassPane для этого апплета

См. также:

getGlassPane(), RootPaneContainer.setGlassPane(java.awt.Component)

getGraphics

public Graphics getGraphics()

Создаёт контекст графики для этого компонента. Этот метод вернёт null если этот компонент в данный момент не отображается.

Переопределяет:

getGraphics в классе Component

Возвращает:

контекст графики для этого компонента, или null если его нет

С:

1.6

См. также:

Component.paint(java.awt.Graphics)

repaint

public void repaint(long time,
                    int x,
                    int y,
                    int width,
                    int height)

Перерисовывает указанный прямоугольник этого компонента в течение time миллисекунд. Обратитесь к RepaintManager для получения подробностей о том, как обрабатывается перерисовка.

Переопределяет:

repaint в классе Component

Параметры:

time - максимальное время в миллисекундах до обновления

x - координата x

y - координата y

width - ширина

height - высота

С:

1.6

См. также:

RepaintManager

paramString

protected String paramString()

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

Переопределяет:

paramString в классе Container

Возвращает:

строковое представление этого JApplet.

getAccessibleContext

public AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим JApplet. Для JApplet AccessibleContext принимает вид AccessibleJApplet. Новый экземпляр AccessibleJApplet создаётся при необходимости.

Указано:

getAccessibleContext в интерфейсе Accessible

Переопределяет:

getAccessibleContext в классе Applet

Возвращает:

AccessibleJApplet, который служит AccessibleContext для этого JApplet