javax.swing
Class JApplet

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Panel
                    |
                    +--java.applet.Applet
                          |
                          +--javax.swing.JApplet
All Implemented Interfaces:
Accessible, ImageObserver, MenuContainer, RootPaneContainer, Serializable
public class JApplet
extends Applet
implements Accessible, RootPaneContainer

An extended version of java.applet.Applet that adds support for the JFC/Swing component architecture. You can find task-oriented documentation about using JApplet in The Java Tutorial, in the section How to Make Applets.

The JApplet class is slightly incompatible with java.applet.Applet. JApplet contains a JRootPane as it's only child. The contentPane should be the parent of any children of the JApplet. This is different than java.applet.Applet, e.g. to add a child to an an java.applet.Applet you'd write:

       applet.add(child);
 
However using JApplet you need to add the child to the JApplet's contentPane instead:
       applet.getContentPane().add(child);
 
The same is true for setting LayoutManagers, removing components, listing children, etc. All these methods should normally be sent to the contentPane() instead of the JApplet itself. The contentPane() will always be non-null. Attempting to set it to null will cause the JApplet to throw an exception. The default contentPane() will have a BorderLayout manager set on it.

Please see the JRootPane documentation for a complete description of the contentPane, glassPane, and layeredPane properties.

For the keyboard keys used by this component in the standard Look and Feel (L&F) renditions, see the JApplet key assignments.

Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeansTM has been added to the java.beans package. Please see XMLEncoder.

 

Nested Class Summary

protected  class JApplet.AccessibleJApplet
    This class implements accessibility support for the JApplet class.
 
Nested classes inherited from class java.applet.Applet
 
Nested classes inherited from class java.awt.Panel
 
Nested classes inherited from class java.awt.Container
 
Nested classes inherited from class java.awt.Component
Component.BltBufferStrategy, Component.FlipBufferStrategy
 

 

Field Summary

protected  AccessibleContext accessibleContext
    
protected  JRootPane rootPane
    
protected  boolean rootPaneCheckingEnabled
    
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 

 

Constructor Summary

JApplet()
    Creates a swing applet instance.
 

 

Method Summary

protected  void addImpl(Component comp, Object constraints, int index)
    By default, children may not be added directly to a this component, they must be added to its contentPane instead.
protected  JRootPane createRootPane()
    Called by the constructor methods to create the default rootPane.
 AccessibleContext getAccessibleContext()
    Gets the AccessibleContext associated with this JApplet.
 Container getContentPane()
    Returns the contentPane object for this applet.
 Component getGlassPane()
    Returns the glassPane object for this applet.
 JMenuBar getJMenuBar()
    Returns the menubar set on this applet.
 JLayeredPane getLayeredPane()
    Returns the layeredPane object for this applet.
 JRootPane getRootPane()
    Returns the rootPane object for this applet.
protected  boolean isRootPaneCheckingEnabled()
    
protected  String paramString()
    Returns a string representation of this JApplet.
 void remove(Component comp)
    Removes the specified component from this container.
 void setContentPane(Container contentPane)
    Sets the contentPane property.
 void setGlassPane(Component glassPane)
    Sets the glassPane property.
 void setJMenuBar(JMenuBar menuBar)
    Sets the menubar for this applet.
 void setLayeredPane(JLayeredPane layeredPane)
    Sets the layeredPane property.
 void setLayout(LayoutManager manager)
    By default the layout of this component may not be set, the layout of its contentPane should be set instead.