Класс 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
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 в пакете java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.
- Начиная с версии:
- 1.2
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
protected class |
JApplet.AccessibleJApplet |
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Этот класс реализует поддержку специальных возможностей для класса JApplet. |
Вложенные классы/интерфейсы, объявленные в классе Applet
Applet.AccessibleApplet
Вложенные классы/интерфейсы, объявленные в классе Panel
Panel.AccessibleAWTPanel
Вложенные классы/интерфейсы, объявленные в классе Container
Container.AccessibleAWTContainer
Вложенные классы/интерфейсы, объявленные в классе 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. |
Поля, объявленные в классе Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Поля, объявленные в интерфейсе ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
JApplet() |
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Создает экземпляр апплета Swing. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
protected void |
addImpl |
Устарело, будет удалено: этот элемент 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 |
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Удаляет указанный компонент из контейнера. |
void |
repaint |
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Перерисовывает указанный прямоугольник этого компонента в течение time миллисекунд. |
void |
setContentPane |
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Устанавливает свойство contentPane. |
void |
setGlassPane |
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Устанавливает свойство glassPane. |
void |
setJMenuBar |
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Устанавливает строку меню для этого апплета. |
void |
setLayeredPane |
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Устанавливает свойство layeredPane. |
void |
setLayout |
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Устанавливает LayoutManager. |
protected void |
setRootPane |
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Устанавливает свойство rootPane. |
protected void |
setRootPaneCheckingEnabled |
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Устанавливает, следует ли перенаправлять вызовы add и setLayout в contentPane. |
void |
setTransferHandler |
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Устанавливает свойство transferHandler, представляющее собой механизм поддержки передачи данных в этот компонент. |
void |
update |
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Просто вызывает paint(g). |
Методы, объявленные в классе 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
Методы, объявленные в классе 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
Методы, объявленные в классе 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
Подробное описание полей
rootPane
protected JRootPane rootPane
JRootPane, управляющий contentPane.- См. также:
rootPaneCheckingEnabled
protected boolean rootPaneCheckingEnabled
add и setLayout будут перенаправлены в contentPane. Изначально значение равно false, но оно устанавливается в true при создании JApplet.- См. также:
accessibleContext
protected AccessibleContext accessibleContext
AccessibleContext, связанный с этим JApplet
Подробное описание конструкторов
JApplet
public JApplet() throws HeadlessException
Этот конструктор задаёт свойству локали компонента значение, возвращаемое методом JComponent.getDefaultLocale.
- Вызывает исключение:
-
HeadlessException— если GraphicsEnvironment.isHeadless() возвращает true. - См. также:
Подробное описание методов
createRootPane
protected JRootPane createRootPane()
- Возвращает:
- новый
JRootPane
setTransferHandler
@BeanProperty(hidden=true, description="Mechanism for transfer of data into the component") public void setTransferHandler(TransferHandler newHandler)
transferHandler, обеспечивающее передачу данных в этот компонент. Используйте null, если компонент не поддерживает операции передачи данных. Если системное свойство suppressSwingDropSupport имеет значение false (по умолчанию), а текущая цель перетаскивания этого компонента равна null или не была задана пользователем, этот метод изменит цель перетаскивания следующим образом: если newHandler равно null, цель перетаскивания будет очищена. Если нет null, будет установлена новая DropTarget.
Примечание: при использовании с JApplet, TransferHandler обеспечивает только возможность импорта данных, поскольку методы, связанные с экспортом данных, в настоящее время имеют тип JComponent.
Дополнительные сведения см. в разделе Использование перетаскивания и передачи данных в Учебнике Java.
- Параметры:
-
newHandler— новыйTransferHandler - Начиная с версии:
- 1.6
- См. также:
getTransferHandler
public TransferHandler getTransferHandler()
transferHandler.- Возвращает:
- значение свойства
transferHandler - Начиная с версии:
- 1.6
- См. также:
update
public void update(Graphics g)
paint(g). Этот метод переопределён, чтобы избежать ненужного вызова очистки фона.setJMenuBar
@BeanProperty(bound=false, hidden=true, description="The menubar for accessing pulldown menus from this applet.") public void setJMenuBar(JMenuBar menuBar)
- Параметры:
-
menuBar— строка меню, размещаемая в апплете - См. также:
getJMenuBar
public JMenuBar getJMenuBar()
- Возвращает:
- строку меню, установленную для этого апплета
- См. также:
isRootPaneCheckingEnabled
protected boolean isRootPaneCheckingEnabled()
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)
add и setLayout в contentPane.- Параметры:
-
enabled— true, еслиaddиsetLayoutперенаправляются; false, если они должны выполняться непосредственно дляJApplet. - См. также:
addImpl
protected void addImpl(Component comp, Object constraints, int index)
Component. Этот метод переопределён для условного перенаправления вызовов в contentPane. По умолчанию дочерние элементы добавляются в contentPane, а не во фрейм; подробности см. в RootPaneContainer.- Переопределяет:
-
addImplв классеContainer - Параметры:
-
comp— компонент, который необходимо добавить -
constraints— ограничения, которые необходимо соблюдать -
index— индекс - Вызывает исключение:
-
IllegalArgumentException— еслиindexнедопустим -
IllegalArgumentException— при добавлении родительского контейнера к самому себе -
IllegalArgumentException— при добавлении окна в контейнер - См. также:
remove
public void remove(Component comp)
comp не является rootPane, вызов будет перенаправлен в contentPane. Ничего не произойдёт, если comp не является дочерним элементом JFrame или contentPane.- Переопределяет:
-
removeв классеContainer - Параметры:
-
comp— компонент, который необходимо удалить - Вызывает исключение:
-
NullPointerException— еслиcompравно null - См. также:
setLayout
public void setLayout(LayoutManager manager)
LayoutManager. Метод переопределён для условного перенаправления вызова в contentPane. Дополнительные сведения см. в RootPaneContainer.getRootPane
@BeanProperty(bound=false, hidden=true, description="the RootPane object for this applet.") public JRootPane getRootPane()
- Определено в:
-
getRootPaneв интерфейсеRootPaneContainer - Возвращает:
- единственный дочерний объект JRootPane этого компонента.
- См. также:
setRootPane
protected void setRootPane(JRootPane root)
- Параметры:
-
root— объект rootPane для этого апплета - См. также:
getContentPane
public Container getContentPane()
- Определено в:
-
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)
- Определено в:
-
setContentPaneв интерфейсеRootPaneContainer - Параметры:
-
contentPane— объект contentPane для этого апплета - Вызывает исключение:
-
IllegalComponentStateException— (исключение времени выполнения), если параметр content pane равен null - См. также:
getLayeredPane
public JLayeredPane getLayeredPane()
- Определено в:
-
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)
- Определено в:
-
setLayeredPaneв интерфейсеRootPaneContainer - Параметры:
-
layeredPane— объект layeredPane для этого апплета - См. также:
getGlassPane
public Component getGlassPane()
- Определено в:
-
getGlassPaneв интерфейсеRootPaneContainer - Возвращает:
- значение свойства glassPane.
- См. также:
setGlassPane
@BeanProperty(bound=false, hidden=true, description="A transparent pane used for menu rendering.") public void setGlassPane(Component glassPane)
- Определено в:
-
setGlassPaneв интерфейсеRootPaneContainer - Параметры:
-
glassPane— объект glassPane для этого апплета - См. также:
getGraphics
@BeanProperty(bound=false) public Graphics getGraphics()
null, если компонент в данный момент не отображается.- Переопределяет:
-
getGraphicsв классеComponent - Возвращает:
- графический контекст для этого компонента или
null, если его нет - Начиная с версии:
- 1.6
- См. также:
repaint
public void repaint(long time, int x, int y, int width, int height)
time миллисекунд. Сведения о том, как выполняется перерисовка, см. в RepaintManager.paramString
protected String paramString()
null.- Переопределяет:
-
paramStringв классеContainer - Возвращает:
- строковое представление этого JApplet.
getAccessibleContext
public AccessibleContext getAccessibleContext()
- Определено в:
-
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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JApplet.html