Класс JApplet

javax.swing.JApplet

Все реализуемые интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer

@Deprecated(since="9", forRemoval=true) @JavaBean(defaultProperty="JMenuBar", description="Swing's Applet subclass.") public class JApplet extends Applet implements Accessible, RootPaneContainer

Устаревший, для удаления: Этот элемент API может быть удалён в будущей версии.

API Апплетов устарел, замены нет.

Расширенная версия 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.

С момента:

1.2

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`JApplet.AccessibleJApplet`	Устаревший, для удаления: Этот элемент API может быть удалён в будущей версии. Этот класс реализует поддержку доступности для класса `JApplet`.

Вложенные классы/интерфейсы, объявленные в классе java.applet.Applet

Applet.AccessibleApplet

Вложенные классы/интерфейсы, объявленные в классе java.awt.Panel

Panel.AccessibleAWTPanel

Вложенные классы/интерфейсы, объявленные в классе java.awt.Container

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, объявленные в классе java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected AccessibleContext`	`accessibleContext`	Устаревший, для удаления: Этот элемент API может быть удалён в будущей версии. `AccessibleContext`, связанное с этим `JApplet`
`protected JRootPane`	`rootPane`	Устаревший, для удаления: Этот элемент API может быть удалён в будущей версии. Экземпляр `JRootPane`, управляющий `contentPane`.
`protected boolean`	`rootPaneCheckingEnabled`	Устаревший, для удаления: Этот элемент API может быть удалён в будущей версии. Если true, то вызовы `add` и `setLayout` будут перенаправлены на `contentPane`.

Поля, объявленные в классе 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

Краткое описание конструкторов

Конструктор	Описание
`JApplet()`	Устаревший, для удаления: Этот элемент API может быть удалён в будущей версии. Создаёт экземпляр апплета Swing.

Краткое описание методов

Modifier and Type	Method	Description
`protected void`	`addImpl(Component comp, Object constraints, int index)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Добавляет указанный дочерний `Component`.
`protected JRootPane`	`createRootPane()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Вызывается методами-конструкторами для создания корневого компонента (rootPane).
`AccessibleContext`	`getAccessibleContext()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Возвращает AccessibleContext, связанный с данным объектом JApplet.
`Container`	`getContentPane()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Возвращает объект contentPane для этого апплета.
`Component`	`getGlassPane()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Возвращает объект glassPane для этого апплета.
`Graphics`	`getGraphics()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Создаёт контекст графики для этого компонента.
`JMenuBar`	`getJMenuBar()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Возвращает строку меню, заданную для этого апплета.
`JLayeredPane`	`getLayeredPane()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Возвращает объект layeredPane для этого апплета.
`JRootPane`	`getRootPane()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Возвращает объект rootPane для этого апплета.
`TransferHandler`	`getTransferHandler()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Получает свойство `transferHandler`.
`protected boolean`	`isRootPaneCheckingEnabled()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Возвращает, перенаправляются ли вызовы `add` и `setLayout` на `contentPane`.
`protected String`	`paramString()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Возвращает строковое представление этого JApplet.
`void`	`remove(Component comp)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Удаляет указанный компонент из контейнера.
`void`	`repaint(long time, int x, int y, int width, int height)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Перерисовывает указанный прямоугольник этого компонента в течение `time` миллисекунд.
`void`	`setContentPane(Container contentPane)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Устанавливает свойство contentPane.
`void`	`setGlassPane(Component glassPane)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Устанавливает свойство glassPane.
`void`	`setJMenuBar(JMenuBar menuBar)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Устанавливает строку меню для этого апплета.
`void`	`setLayeredPane(JLayeredPane layeredPane)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Устанавливает свойство layeredPane.
`void`	`setLayout(LayoutManager manager)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Устанавливает `LayoutManager`.
`protected void`	`setRootPane(JRootPane root)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Устанавливает свойство rootPane.
`protected void`	`setRootPaneCheckingEnabled(boolean enabled)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Устанавливает, перенаправляются ли вызовы `add` и `setLayout` на `contentPane`.
`void`	`setTransferHandler(TransferHandler newHandler)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Устанавливает свойство `transferHandler`, которое служит механизмом для поддержки передачи данных в этот компонент.
`void`	`update(Graphics g)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Просто вызывает `paint(g)`.

Методы, объявленные в классе java.applet.Applet

destroy, getAppletContext, getAppletInfo, getAudioClip, getAudioClip, getCodeBase, getDocumentBase, getImage, getImage, getLocale, getParameter, getParameterInfo, init, isActive, isValidateRoot, newAudioClip, play, play, resize, resize, setStub, showStatus, start, stop

Методы, объявленные в классе java.awt.Panel

addNotify

Методы, объявленные в классе java.awt.Container

add, add, add, add, add, addContainerListener, 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, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, 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, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, 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, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, 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

Подробное описание полей

rootPane

protected JRootPane rootPane

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

Экземпляр JRootPane, управляющий contentPane.

См. также:

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

См. также:

accessibleContext

protected AccessibleContext accessibleContext

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

AccessibleContext, связанный с этим JApplet.

Подробное описание конструкторов

JApplet

public JApplet() throws HeadlessException

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

Создаёт экземпляр апплета Swing.

Этот конструктор устанавливает свойство locale компонента в значение, возвращаемое JComponent.getDefaultLocale.

Исключения:

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

См. также:

Подробное описание методов

createRootPane

protected JRootPane createRootPane()

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

Возвращает:: новый JRootPane

setTransferHandler

@BeanProperty(hidden=true, description="Mechanism for transfer of data into the component") public void setTransferHandler(TransferHandler newHandler)

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

Устанавливает свойство transferHandler, которое является механизмом поддержки перетаскивания данных в этот компонент. Используйте null, если компонент не поддерживает операции передачи данных.

Если системное свойство suppressSwingDropSupport равно false (по умолчанию), и текущий целевой объект перетаскивания на этом компоненте является либо null, либо не является установленным пользователем целевым объектом перетаскивания, этот метод изменит целевой объект перетаскивания следующим образом: если newHandler равно null, он очистит целевой объект перетаскивания. В противном случае установит новый DropTarget.

Примечание: При использовании с JApplet, TransferHandler предоставляет только возможность импорта данных, так как методы, связанные с экспортом данных, в настоящее время типизированы как JComponent.

Дополнительную информацию можно найти в разделе Как использовать перетаскивание и передачу данных в Руководстве Java.

Параметры:

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

С:

1.6

См. также:

getTransferHandler

public TransferHandler getTransferHandler()

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

Возвращает:

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

С:

1.6

См. также:

update

public void update(Graphics g)

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

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

update в классе Container

Параметры:

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

См. также:

setJMenuBar

@BeanProperty(bound=false, hidden=true, description="The menubar for accessing pulldown menus from this applet.") public void setJMenuBar(JMenuBar menuBar)

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

Параметры:

menuBar - панель меню, устанавливаемая в апплет

См. также:

getJMenuBar

public JMenuBar getJMenuBar()

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

Возвращает:

панель меню, установленную для этого апплета

См. также:

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

Возвращает:

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

См. также:

setRootPaneCheckingEnabled

@BeanProperty(hidden=true, description="Whether the add and setLayout methods are forwarded") protected void setRootPaneCheckingEnabled(boolean enabled)

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

Параметры:

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

См. также:

addImpl

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

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

Overrides:

addImpl в классе Container

Параметры:

comp - компонент, который будет улучшен

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

index - индекс

Исключения:

IllegalArgumentException - если index недействителен

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

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

См. также:

remove

public void remove(Component comp)

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

Overrides:

remove в классе Container

Параметры:

comp - компонент, который будет удалён

Исключения:

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

См. также:

setLayout

public void setLayout(LayoutManager manager)

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

Устанавливает LayoutManager. Переопределяется, чтобы условно перенаправлять вызов в contentPane. См. RootPaneContainer для получения дополнительной информации.

Overrides:

setLayout в классе Container

Параметры:

manager - LayoutManager

См. также:

getRootPane

@BeanProperty(bound=false, hidden=true, description="the RootPane object for this applet.") public JRootPane getRootPane()

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

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

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

Возвращает:

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

См. также:

setRootPane

protected void setRootPane(JRootPane root)

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

Параметры:

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

См. также:

getContentPane

public Container getContentPane()

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

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

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

Возвращает:

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

См. также:

setContentPane

@BeanProperty(bound=false, hidden=true, description="The client area of the applet where child components are normally inserted.") public void setContentPane(Container contentPane)

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

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

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

Параметры:

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

Исключения:

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

См. также:

getLayeredPane

public JLayeredPane getLayeredPane()

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

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

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

Возвращает:

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

Исключения:

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

См. также:

setLayeredPane

@BeanProperty(bound=false, hidden=true, description="The pane which holds the various applet layers.") public void setLayeredPane(JLayeredPane layeredPane)

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

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

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

Параметры:

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

См. также:

getGlassPane

public Component getGlassPane()

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

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

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

Возвращает:

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

См. также:

setGlassPane

@BeanProperty(bound=false, hidden=true, description="A transparent pane used for menu rendering.") public void setGlassPane(Component glassPane)

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

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

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

Параметры:

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

См. также:

getGraphics

@BeanProperty(bound=false) public Graphics getGraphics()

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

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

Overrides:

getGraphics в классе Component

Возвращает:

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

Since:

1.6

См. также:

перерисовка

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

Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии.

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

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

repaint в классе Component

Параметры:

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

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

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

width - ширина

height - высота

С:

1.6

См. также:

paramString

protected String paramString()

Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии.

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

Переопределяет:: paramString в классе Container
Возвращает:: строковое представление этого JApplet.

getAccessibleContext

public AccessibleContext getAccessibleContext()

Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии.

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

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Applet
Возвращает:: AccessibleJApplet, который служит AccessibleContext этого JApplet

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/JApplet.html