Класс JApplet
- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- java.awt.Panel
-
- java.applet.Applet
-
- javax.swing.JApplet
- Все реализованные интерфейсы:
-
ImageObserver,MenuContainer,Serializable,Accessible,RootPaneContainer
@Deprecated(since="9")
@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, поддержка долговременного хранения всех JavaBeans™ была добавлена в пакет java.beans. См. XMLEncoder.
- С:
- 1.2
- См. также:
-
RootPaneContainer, Сериализованная форма
Вложенные классы
| Модификатор и тип | Класс | Описание |
|---|---|---|
protected class | JApplet.AccessibleJApplet | Устаревшее. Этот класс реализует поддержку доступности для класса |
Вложенные классы/интерфейсы, объявленные в классе 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 | Устаревшее.
|
protected JRootPane | rootPane | Устаревшее. |
protected boolean | rootPaneCheckingEnabled | Устаревшее. Если true, то вызовы |
Поля, объявленные в классе 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() | Устаревшее. Создает экземпляр апплета Swing. |
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
protected void | addImpl(Component comp,
Object constraints,
int index) | Устаревшее. Добавляет указанного дочернего |
protected JRootPane | createRootPane() | Устаревшее. Вызывается методами-конструкторами для создания по умолчанию rootPane. |
AccessibleContext | getAccessibleContext() | Устаревшее. Получает AccessibleContext, связанный с этим JApplet. |
Container | getContentPane() | Устаревшее. Возвращает объект contentPane для этого аплета. |
Component | getGlassPane() | Устаревшее. Возвращает объект glassPane для этого аплета. |
Graphics | getGraphics() | Устаревшее. Создаёт контекст графики для этого компонента. |
JMenuBar | getJMenuBar() | Устаревшее. Возвращает установленную в этом аплете панель меню. |
JLayeredPane | getLayeredPane() | Устаревшее. Возвращает объект layeredPane для этого аплета. |
JRootPane | getRootPane() | Устаревшее. Возвращает объект rootPane для этого аплета. |
TransferHandler | getTransferHandler() | Устаревшее. Получает свойство |
protected boolean | isRootPaneCheckingEnabled() | Устаревшее. Возвращает, перенаправляются ли вызовы |
protected String | paramString() | Устаревшее. Возвращает строковое представление этого JApplet. |
void | remove(Component comp) | Устаревшее. Удаляет указанный компонент из контейнера. |
void | repaint(long time,
int x,
int y,
int width,
int height) | Устаревшее. Перерисовывает указанный прямоугольник этого компонента в течение |
void | setContentPane(Container contentPane) | Устаревшее. Устанавливает свойство contentPane. |
void | setGlassPane(Component glassPane) | Устаревшее. Устанавливает свойство glassPane. |
void | setJMenuBar(JMenuBar menuBar) | Устаревшее. Устанавливает панель меню для этого аплета. |
void | setLayeredPane(JLayeredPane layeredPane) | Устаревшее. Устанавливает свойство layeredPane. |
void | setLayout(LayoutManager manager) | Устаревшее. Устанавливает |
protected void | setRootPane(JRootPane root) | Устаревшее. Устанавливает свойство rootPane. |
protected void | setRootPaneCheckingEnabled(boolean enabled) | Устаревшее. Устанавливает, перенаправляются ли вызовы |
void | setTransferHandler(TransferHandler newHandler) | Устаревшее. Устанавливает свойство |
void | update(Graphics 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
- См. также:
-
getRootPane(),setRootPane(javax.swing.JRootPane)
rootPaneCheckingEnabled
protected boolean rootPaneCheckingEnabled
Если true, то вызовы add и setLayout будут перенаправлены в contentPane. По умолчанию false, но устанавливается в true при создании JApplet.
accessibleContext
protected AccessibleContext accessibleContext
AccessibleContext связанный с этим JApplet
Конструкторы
JApplet
public JApplet()
throws HeadlessException Создаёт экземпляр аплета swing.
Этот конструктор устанавливает свойство locale компонента в значение, возвращённое JComponent.getDefaultLocale.
- Исключение:
-
HeadlessException- если GraphicsEnvironment.isHeadless() возвращает true. - См. также:
-
GraphicsEnvironment.isHeadless(),JComponent.getDefaultLocale()
Методы
createRootPane
protected JRootPane createRootPane()
Вызывается методами конструктора для создания стандартной rootPane.
- Возвращает:
- новый
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.
Дополнительные сведения см. в разделе Использование перетаскивания и передачи данных в руководстве The Java Tutorial.
- Параметры:
-
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- указанное окно Graphics - См. также:
Component.update(Graphics)
setJMenuBar
@BeanProperty(bound=false,
hidden=true,
description="The menubar for accessing pulldown menus from this applet.")
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
@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(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
@BeanProperty(bound=false,
hidden=true,
description="the RootPane object for this applet.")
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
@BeanProperty(bound=false,
hidden=true,
description="The client area of the applet where child components are normally inserted.")
public void setContentPane(Container contentPane) Устанавливает свойство contentPane. Этот метод вызывается конструктором.
- Указано в:
-
setContentPaneв интерфейсеRootPaneContainer - Параметры:
-
contentPane- объект contentPane для этого апплета - Исключения:
-
IllegalComponentStateException- (исключение времени выполнения), если параметр content pane равен null - См. также:
-
getContentPane(),RootPaneContainer.setContentPane(java.awt.Container)
getLayeredPane
public JLayeredPane getLayeredPane()
Возвращает объект layeredPane для этого апплета.
- Указано в:
-
getLayeredPaneв интерфейсеRootPaneContainer - Возвращает:
- значение свойства layeredPane.
- Исключения:
-
IllegalComponentStateException- (исключение времени выполнения), если параметр layered pane равен null - См. также:
-
setLayeredPane(javax.swing.JLayeredPane),RootPaneContainer.getLayeredPane()
setLayeredPane
@BeanProperty(bound=false,
hidden=true,
description="The pane which holds the various applet layers.")
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
@BeanProperty(bound=false,
hidden=true,
description="A transparent pane used for menu rendering.")
public void setGlassPane(Component glassPane) Устанавливает свойство glassPane. Этот метод вызывается конструктором.
- Указано в:
-
setGlassPaneв интерфейсеRootPaneContainer - Параметры:
-
glassPane- объект glassPane для этого апплета - См. также:
-
getGlassPane(),RootPaneContainer.setGlassPane(java.awt.Component)
getGraphics
@BeanProperty(bound=false) 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
© 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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/javax/swing/JApplet.html