javax.swing
Class CellRendererPane

java.lang.Object   
  java.awt.Component   
      java.awt.Container   
          javax.swing.CellRendererPane

All Implemented Interfaces:

ImageObserver , MenuContainer , Serializable , Accessible

public class CellRendererPane
extends Container   
implements Accessible   

This class is inserted in between cell renderers and the components that use them. It just exists to thwart the repaint() and invalidate() methods which would otherwise propagate up the tree when the renderer was configured. It's used by the implementations of JTable, JTree, and JList. For example, here's how CellRendererPane is used in the code the paints each row in a JList:

   cellRendererPane = new CellRendererPane();
   ...
   Component rendererComponent = renderer.getListCellRendererComponent();
   renderer.configureListCellRenderer(dataModel.getElementAt(row), row);
   cellRendererPane.paintComponent(g, rendererComponent, this, x, y, w, h);
 

A renderer component must override isShowing() and unconditionally return true to work correctly because the Swing paint does nothing for components with isShowing false.

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

See Also:

Serialized Form

Nested Class Summary

protected class

CellRendererPane.AccessibleCellRendererPane This class implements accessibility support for the CellRendererPane class.

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent , Component.BltBufferStrategy , Component.FlipBufferStrategy

Field Summary

protected AccessibleContext

accessibleContext

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

CellRendererPane ()
Construct a CellRendererPane object.

Method Summary

protected void	addImpl (Component x, Object constraints, int index) If the specified component is already a child of this then we don't bother doing anything - stacking order doesn't matter for cell renderer components (CellRendererPane doesn't paint anyway).<
AccessibleContext	getAccessibleContext () Gets the AccessibleContext associated with this CellRendererPane.
void	invalidate () Overridden to avoid propagating a invalidate up the tree when the cell renderer child is configured.
void	paint (Graphics g) Shouldn't be called.
void	paintComponent (Graphics g, Component c, Container p, int x, int y, int w, int h) Calls this.paintComponent(g, c, p, x, y, w, h, false).
void	paintComponent (Graphics g, Component c, Container p, int x, int y, int w, int h, boolean shouldValidate) Paint a cell renderer component c on graphics object g.
void	paintComponent (Graphics g, Component c, Container p, Rectangle r) Calls this.paintComponent() with the rectangles x,y,width,height fields.
void	update (Graphics g) Shouldn't be called.

Methods inherited from class java.awt.Container

add , add , add , add , add , addContainerListener , addNotify , 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 , isAncestorOf , isFocusCycleRoot , isFocusCycleRoot , isFocusTraversalPolicyProvider , isFocusTraversalPolicySet , layout , list , list , locate , minimumSize , paintComponents , paramString , preferredSize , print , printComponents , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , removeNotify , setComponentZOrder , setFocusCycleRoot , setFocusTraversalKeys , setFocusTraversalPolicy , setFocusTraversalPolicyProvider , setFont , setLayout , transferFocusBackward , transferFocusDownCycle , validate , validateTree

Methods inherited from class 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