JPanel is a generic lightweight container. For examples and task-oriented documentation for JPanel, see How to Use Panels, a section in The Java Tutorial.

Warning

Swing is not thread safe. For more information see Swing's Threading Policy.

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 JavaBeans has been added to the java.beans package. Please see java.beans.XMLEncoder.

Nested and Inner Type Summary

Modifier and Type	Class and Description
protected class	JPanel.AccessibleJPanel This class implements accessibility support for the `JPanel` class.

Field Summary

Modifier and Type	Field and Description
private static final String	uiClassID Hides javax.swing.JComponent.uiClassID.

Inherited from javax.swing.JComponent:: DEBUG_GRAPHICS_LOADED focusController ivSourceComponent listenerList paintingChild TOOL_TIP_TEXT_KEY ui UNDEFINED_CONDITION WHEN_ANCESTOR_OF_FOCUSED_COMPONENT WHEN_FOCUSED WHEN_IN_FOCUSED_WINDOW

Constructor Summary

Access	Constructor and Description
public	JPanel(LayoutManager the LayoutManager to use layout, boolean a boolean, true for double-buffering, which uses additional memory space to achieve fast, flicker-free updates isDoubleBuffered) Creates a new JPanel with the specified layout manager and buffering strategy.
public	JPanel(LayoutManager the LayoutManager to use layout) Create a new buffered JPanel with the specified layout manager
public	JPanel(boolean a boolean, true for double-buffering, which uses additional memory space to achieve fast, flicker-free updates isDoubleBuffered) Creates a new `JPanel` with `FlowLayout` and the specified buffering strategy.
public	JPanel() Creates a new `JPanel` with a double buffer and a flow layout.

Method Summary

Modifier and Type	Method and Description
public AccessibleContext	Returns: an AccessibleJPanel that serves as the AccessibleContext of this JPanel getAccessibleContext() Overrides java.awt.Component.getAccessibleContext. Implements javax.accessibility.Accessible.getAccessibleContext. Gets the AccessibleContext associated with this JPanel.
public PanelUI	Returns: the PanelUI object that renders this component getUI() Overrides javax.swing.JComponent.getUI. Returns the look and feel (L&F) object that renders this component.
public String	Returns: the string "PanelUI" getUIClassID() Overrides javax.swing.JComponent.getUIClassID. Returns a string that specifies the name of the L&F class that renders this component.
protected String	Returns: a string representation of this JPanel. paramString() Overrides javax.swing.JComponent.paramString. Returns a string representation of this JPanel.
public void	setUI(PanelUI the PanelUI L&F object ui) Sets the look and feel (L&F) object that renders this component.
public void	updateUI() Overrides javax.swing.JComponent.updateUI. Resets the UI property with a value from the current look and feel.
private void	writeObject(ObjectOutputStream s) Hides javax.swing.JComponent.writeObject. See readObject() and writeObject() in JComponent for more information about serialization in Swing.

Inherited from javax.swing.JComponent:: _paintImmediately addAncestorListener addNotify addVetoableChangeListener alwaysOnTop checkIfChildObscuredBySibling clientPropertyChanged componentInputMapChanged computeVisibleRect computeVisibleRect compWriteObjectNotify contains createToolTip disable dndDone dropLocationForPoint enable firePropertyChange firePropertyChange firePropertyChange fireVetoableChange getActionForKeyStroke getActionMap getActionMap getAlignmentX getAlignmentY getAncestorListeners getAutoscrolls getBaseline getBaselineResizeBehavior getBorder getBounds getClientProperty getComponentGraphics getComponentPopupMenu getConditionForKeyStroke getCreatedDoubleBuffer getDebugGraphicsOptions getDefaultLocale getFontMetrics getGraphics getGraphicsInvoked getHeight getInheritsPopupMenu getInputMap getInputMap getInputMap getInputVerifier getInsets getInsets getListeners getLocation getManagingFocusBackwardTraversalKeys getManagingFocusForwardTraversalKeys getMaximumSize getMinimumSize getNextFocusableComponent getPopupLocation getPreferredSize getRegisteredKeyStrokes getRootPane getSize getToolTipLocation getToolTipText getToolTipText getTopLevelAncestor getTransferHandler getVerifyInputWhenFocusTarget getVetoableChangeListeners getVisibleRect getWidth getWriteObjCounter getX getY grabFocus hide isDoubleBuffered isLightweightComponent isManagingFocus isOpaque isOptimizedDrawingEnabled isPainting isPaintingForPrint isPaintingOrigin isPaintingTile isRequestFocusEnabled isValidateRoot paint paintBorder paintChildren paintComponent paintForceDoubleBuffered paintImmediately paintImmediately paintToOffscreen print printAll printBorder printChildren printComponent processComponentKeyEvent processKeyBinding processKeyBindings processKeyBindingsForAllComponents processKeyEvent processMouseEvent processMouseMotionEvent putClientProperty rectangleIsObscured registerKeyboardAction registerKeyboardAction removeAncestorListener removeNotify removeVetoableChangeListener repaint repaint requestDefaultFocus requestFocus requestFocus requestFocusInWindow requestFocusInWindow resetKeyboardActions reshape revalidate safelyGetGraphics safelyGetGraphics scrollRectToVisible setActionMap setAlignmentX setAlignmentY setAutoscrolls setBackground setBorder setComponentPopupMenu setCreatedDoubleBuffer setDebugGraphicsOptions setDefaultLocale setDoubleBuffered setDropLocation setEnabled setFocusTraversalKeys setFont setForeground setInheritsPopupMenu setInputMap setInputVerifier setMaximumSize setMinimumSize setNextFocusableComponent setOpaque setPaintingChild setPreferredSize setRequestFocusEnabled setToolTipText setTransferHandler setUI setUIProperty setVerifyInputWhenFocusTarget setVisible setWriteObjCounter shouldDebugGraphics superProcessMouseMotionEvent unregisterKeyboardAction update

Field Detail

uiClassID back to summary

uiClassID	back to summary
private static final String uiClassID Hides javax.swing.JComponent.uiClassID. See Also `getUIClassID`, `readObject`

private static final String uiClassID

Hides javax.swing.JComponent.uiClassID.

See Also: getUIClassID, readObject

Constructor Detail

JPanel	back to summary
public JPanel(LayoutManager layout, boolean isDoubleBuffered) Creates a new JPanel with the specified layout manager and buffering strategy. Parameters layout:LayoutManager the LayoutManager to use isDoubleBuffered:boolean a boolean, true for double-buffering, which uses additional memory space to achieve fast, flicker-free updates

JPanel

back to summary

public JPanel(LayoutManager layout, boolean isDoubleBuffered)

Creates a new JPanel with the specified layout manager and buffering strategy.

Parameters

layout:LayoutManager: the LayoutManager to use
isDoubleBuffered:boolean: a boolean, true for double-buffering, which uses additional memory space to achieve fast, flicker-free updates

JPanel	back to summary
public JPanel(LayoutManager layout) Create a new buffered JPanel with the specified layout manager Parameters layout:LayoutManager the LayoutManager to use

JPanel

back to summary

public JPanel(LayoutManager layout)

Create a new buffered JPanel with the specified layout manager

Parameters

layout:LayoutManager: the LayoutManager to use

JPanel back to summary

JPanel	back to summary
public JPanel(boolean isDoubleBuffered) Creates a new `JPanel` with `FlowLayout` and the specified buffering strategy. If `isDoubleBuffered` is true, the `JPanel` will use a double buffer. Parameters isDoubleBuffered:boolean a boolean, true for double-buffering, which uses additional memory space to achieve fast, flicker-free updates

public JPanel(boolean isDoubleBuffered)

Creates a new JPanel with FlowLayout and the specified buffering strategy. If isDoubleBuffered is true, the JPanel will use a double buffer.

Parameters

isDoubleBuffered:boolean: a boolean, true for double-buffering, which uses additional memory space to achieve fast, flicker-free updates

JPanel	back to summary
public JPanel() Creates a new `JPanel` with a double buffer and a flow layout.

Method Detail

getAccessibleContext	back to summary
public AccessibleContext getAccessibleContext() Overrides java.awt.Component.getAccessibleContext. Implements javax.accessibility.Accessible.getAccessibleContext. Gets the AccessibleContext associated with this JPanel. For JPanels, the AccessibleContext takes the form of an AccessibleJPanel. A new AccessibleJPanel instance is created if necessary. Returns:AccessibleContext an AccessibleJPanel that serves as the AccessibleContext of this JPanel Annotations @BeanProperty bound:false

getAccessibleContext

back to summary

public AccessibleContext getAccessibleContext()

Overrides java.awt.Component.getAccessibleContext.

Implements javax.accessibility.Accessible.getAccessibleContext.

Gets the AccessibleContext associated with this JPanel. For JPanels, the AccessibleContext takes the form of an AccessibleJPanel. A new AccessibleJPanel instance is created if necessary.

Returns:AccessibleContext

an AccessibleJPanel that serves as the AccessibleContext of this JPanel

Annotations

@BeanProperty
bound:false

getUI	back to summary
public PanelUI getUI() Overrides javax.swing.JComponent.getUI. Returns the look and feel (L&F) object that renders this component. Returns:PanelUI the PanelUI object that renders this component Since 1.4

getUI

back to summary

public PanelUI getUI()

Overrides javax.swing.JComponent.getUI.

Returns the look and feel (L&F) object that renders this component.

Returns:PanelUI: the PanelUI object that renders this component
Since: 1.4

getUIClassID back to summary

getUIClassID	back to summary
public String getUIClassID() Overrides javax.swing.JComponent.getUIClassID. Returns a string that specifies the name of the L&F class that renders this component. Returns:String the string "PanelUI" Annotations @BeanProperty bound:false expert:true description:A string that specifies the name of the L&F class. See Also `JComponent#getUIClassID`, `UIDefaults#getUI`

public String getUIClassID()

Overrides javax.swing.JComponent.getUIClassID.

Returns a string that specifies the name of the L&F class that renders this component.

Returns:String

the string "PanelUI"

Annotations

@BeanProperty
bound:false
expert:true
description:A string that specifies the name of the L&F class.

paramString back to summary

paramString	back to summary
protected String paramString() Overrides javax.swing.JComponent.paramString. Returns a string representation of this JPanel. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be `null`. Returns:String a string representation of this JPanel.

protected String paramString()

Overrides javax.swing.JComponent.paramString.

Returns a string representation of this JPanel. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null.

Returns:String: a string representation of this JPanel.

setUI back to summary

setUI	back to summary
public void setUI(PanelUI ui) Sets the look and feel (L&F) object that renders this component. Parameters ui:PanelUI the PanelUI L&F object Annotations @BeanProperty hidden:true visualUpdate:true description:The UI object that implements the Component\'s LookAndFeel. Since 1.4 See Also `UIDefaults#getUI`

public void setUI(PanelUI ui)

Sets the look and feel (L&F) object that renders this component.

Parameters

ui:PanelUI: the PanelUI L&F object

Annotations

@BeanProperty
hidden:true
visualUpdate:true
description:The UI object that implements the Component\'s LookAndFeel.

Since

1.4

See Also

UIDefaults#getUI

updateUI back to summary

updateUI	back to summary
public void updateUI() Overrides javax.swing.JComponent.updateUI. Resets the UI property with a value from the current look and feel. See Also `JComponent#updateUI`

public void updateUI()

Overrides javax.swing.JComponent.updateUI.

Resets the UI property with a value from the current look and feel.

See Also: JComponent#updateUI

writeObject	back to summary
private void writeObject(ObjectOutputStream s) throws IOException Hides javax.swing.JComponent.writeObject. See readObject() and writeObject() in JComponent for more information about serialization in Swing. Annotations @Serial Exceptions IOException: Doc from java.awt.Container.writeObject. if an I/O error occurs

writeObject

back to summary

private void writeObject(ObjectOutputStream s) throws IOException

Hides javax.swing.JComponent.writeObject.

See readObject() and writeObject() in JComponent for more information about serialization in Swing.

Annotations

@Serial

Exceptions

IOException:

Doc from java.awt.Container.writeObject.

if an I/O error occurs

javax.swing back to summary

protected Class JPanel.AccessibleJPanel

Class Inheritance

extends AccessibleJComponent

java.lang.Object
javax.accessibility.AccessibleContext
java.awt.Component.AccessibleAWTComponent
java.awt.Container.AccessibleAWTContainer
javax.swing.JComponent.AccessibleJComponent
javax.swing.JPanel.AccessibleJPanel

Annotations

@SuppressWarnings:serial

This class implements accessibility support for the JPanel class. It provides an implementation of the Java Accessibility API appropriate to panel user-interface elements.

Warning

Field Summary

Inherited from javax.swing.JComponent.AccessibleJComponent:: accessibleFocusHandler

Constructor Summary

Access	Constructor and Description
protected	AccessibleJPanel() Constructs an `AccessibleJPanel`.

Method Summary

Modifier and Type	Method and Description
public AccessibleRole	Returns: an instance of AccessibleRole describing the role of the object getAccessibleRole() Overrides javax.swing.JComponent.AccessibleJComponent.getAccessibleRole. Get the role of this object.

Inherited from javax.swing.JComponent.AccessibleJComponent:: addPropertyChangeListener getAccessibleChild getAccessibleChildrenCount getAccessibleDescription getAccessibleExtendedComponent getAccessibleKeyBinding getAccessibleName getAccessibleStateSet getBorderTitle getTitledBorderText getToolTipText removePropertyChangeListener

Constructor Detail

AccessibleJPanel	back to summary
protected AccessibleJPanel() Constructs an `AccessibleJPanel`.

Method Detail

getAccessibleRole	back to summary
public AccessibleRole getAccessibleRole() Overrides javax.swing.JComponent.AccessibleJComponent.getAccessibleRole. Get the role of this object. Returns:AccessibleRole an instance of AccessibleRole describing the role of the object

getAccessibleRole

back to summary

public AccessibleRole getAccessibleRole()

Overrides javax.swing.JComponent.AccessibleJComponent.getAccessibleRole.

Get the role of this object.

Returns:AccessibleRole: an instance of AccessibleRole describing the role of the object

public Class JPanel

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

protected Class JPanel.AccessibleJPanel

Field Summary

Constructor Summary

Method Summary

Constructor Detail

Method Detail