JavaTM 2 Platform Std. Ed. v1.6.0
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 JavaBeansTM
has been added to the java.beans package.
Please see XMLEncoder .
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, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, 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, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusUpCycle |
accessibleContext
protected AccessibleContext accessibleContext
CellRendererPane
public CellRendererPane()
- Construct a CellRendererPane object.
invalidate
public void invalidate()
- Overridden to avoid propagating a invalidate up the tree when the
cell renderer child is configured.
- Overrides:
invalidate in class Container
- See Also:
Container.validate() ,
Container.layout() ,
LayoutManager ,
LayoutManager2.invalidateLayout(Container)
paint
public void paint(Graphics g)
- Shouldn't be called.
- Overrides:
paint in class Container
- Parameters:
g - the specified Graphics window- See Also:
Component.update(Graphics)
update
public void update(Graphics g)
- Shouldn't be called.
- Overrides:
update in class Container
- Parameters:
g - the specified Graphics window- See Also:
Component.update(Graphics)
addImpl
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).<
- Overrides:
addImpl in class Container
- Parameters:
x - the component to be addedconstraints - an object expressing layout constraints
for this componentindex - the position in the container's list at which to
insert the component, where -1
means append to the end- See Also:
Container.add(Component) ,
Container.add(Component, int) ,
Container.add(Component, java.lang.Object) ,
LayoutManager ,
LayoutManager2
paintComponent
public 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. Before the component
is drawn it's reparented to this (if that's necessary), it's bounds
are set to w,h and the graphics object is (effectively) translated to x,y.
If it's a JComponent, double buffering is temporarily turned off. After
the component is painted it's bounds are reset to -w, -h, 0, 0 so that, if
it's the last renderer component painted, it will not start consuming input.
The Container p is the component we're actually drawing on, typically it's
equal to this.getParent(). If shouldValidate is true the component c will be
validated before painted.
paintComponent
public 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).
paintComponent
public void paintComponent(Graphics g,
Component c,
Container p,
Rectangle r)
- Calls this.paintComponent() with the rectangles x,y,width,height fields.
getAccessibleContext
public AccessibleContext getAccessibleContext()
- Gets the AccessibleContext associated with this CellRendererPane.
For CellRendererPanes, the AccessibleContext takes the form of an
AccessibleCellRendererPane.
A new AccessibleCellRendererPane instance is created if necessary.
- Specified by:
getAccessibleContext in interface Accessible - Overrides:
getAccessibleContext in class Component
- Returns:
- an AccessibleCellRendererPane that serves as the
AccessibleContext of this CellRendererPane
Copyright 2003 Sun Microsystems, Inc. All rights reserved
|