Класс 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	Описание
`protected void`	`addImpl(Component comp, Object constraints, int index)`	Устаревший, для удаления: Этот элемент API может быть удалён в будущей версии. Добавляет указанного дочернего `Component`.
`protected JRootPane`	`createRootPane()`	Устаревший, для удаления: Этот элемент API может быть удалён в будущей версии. Вызывается методами конструктора для создания панели по умолчанию.
`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.

Этот конструктор устанавливает свойство локали компонента в значение, возвращаемое 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, он очистит цель перетаскивания. Если не равно 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 - заданное окно Graphics

См. также:

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.

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

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 - (исключение времени выполнения) если параметр layeredPane равен 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, если его нет

С тех пор:

1.6

См. также:

repaint

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

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

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

Overrides:

repaint в классе Component

Параметры:

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

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

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

width - ширина

height - высота

С тех пор:

1.6

См. также:

paramString

protected String paramString()

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

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

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

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

© 1993, 2023, 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/21/docs/api/java.desktop/javax/swing/JApplet.html