public class

DefaultTableCellRenderer

extends JLabel
implements Serializable TableCellRenderer
java.lang.Object
   ↳ java.awt.Component
     ↳ java.awt.Container
       ↳ javax.swing.JComponent
         ↳ javax.swing.JLabel
           ↳ javax.swing.table.DefaultTableCellRenderer
Known Direct Subclasses

Class Overview

The standard class for rendering (displaying) individual cells in a JTable.

Implementation Note: This class inherits from JLabel, a standard component class. However JTable employs a unique mechanism for rendering its cells and therefore requires some slightly modified behavior from its cell renderer. The table class defines a single cell renderer and uses it as a as a rubber-stamp for rendering all cells in the table; it renders the first cell, changes the contents of that cell renderer, shifts the origin to the new location, re-draws it, and so on. The standard JLabel component was not designed to be used this way and we want to avoid triggering a revalidate each time the cell is drawn. This would greatly decrease performance because the revalidate message would be passed up the hierarchy of the container to determine whether any other components would be affected. As the renderer is only parented for the lifetime of a painting operation we similarly want to avoid the overhead associated with walking the hierarchy for painting operations. So this class overrides the validate, invalidate, revalidate, repaint, and firePropertyChange methods to be no-ops and override the isOpaque method solely to improve performance. If you write your own renderer, please keep this performance consideration in mind.

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.

See Also

Summary

Nested Classes
class DefaultTableCellRenderer.UIResource A subclass of DefaultTableCellRenderer that implements UIResource
[Expand]
Inherited Constants
From class javax.swing.JComponent
From class java.awt.Component
From interface java.awt.image.ImageObserver
From interface javax.swing.SwingConstants
Fields
protected static Border noFocusBorder
[Expand]
Inherited Fields
From class javax.swing.JLabel
From class javax.swing.JComponent
Public Constructors
DefaultTableCellRenderer()
Creates a default table cell renderer.
Public Methods
void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
Overridden for performance reasons.
Component getTableCellRendererComponent(JTable table, Object value, boolean isSelected, boolean hasFocus, int row, int column)
Returns the default table cell renderer.
void invalidate()
Overridden for performance reasons.
boolean isOpaque()
Overridden for performance reasons.
void repaint()
Overridden for performance reasons.
void repaint(long tm, int x, int y, int width, int height)
Overridden for performance reasons.
void repaint(Rectangle r)
Overridden for performance reasons.
void revalidate()
Overridden for performance reasons.
void setBackground(Color c)
Overrides JComponent.setBackground to assign the unselected-background color to the specified color.
void setForeground(Color c)
Overrides JComponent.setForeground to assign the unselected-foreground color to the specified color.
void updateUI()
Notification from the UIManager that the look and feel [L&F] has changed.
void validate()
Overridden for performance reasons.
Protected Methods
void firePropertyChange(String propertyName, Object oldValue, Object newValue)
Overridden for performance reasons.
void setValue(Object value)
Sets the String object for the cell being rendered to value.
[Expand]
Inherited Methods
From class javax.swing.JLabel
From class javax.swing.JComponent
From class java.awt.Container
From class java.awt.Component
From class java.lang.Object
From interface java.awt.MenuContainer
From interface java.awt.image.ImageObserver
From interface javax.accessibility.Accessible
From interface javax.swing.table.TableCellRenderer

Fields

protected static Border noFocusBorder

Public Constructors

public DefaultTableCellRenderer ()

Creates a default table cell renderer.

Public Methods

public void firePropertyChange (String propertyName, boolean oldValue, boolean newValue)

Overridden for performance reasons. See the Implementation Note for more information.

Parameters
propertyName the property whose value has changed
oldValue the property's previous value
newValue the property's new value

public Component getTableCellRendererComponent (JTable table, Object value, boolean isSelected, boolean hasFocus, int row, int column)

Returns the default table cell renderer.

During a printing operation, this method will be called with isSelected and hasFocus values of false to prevent selection and focus from appearing in the printed output. To do other customization based on whether or not the table is being printed, check the return value from isPaintingForPrint().

Parameters
table the JTable
value the value to assign to the cell at [row, column]
isSelected true if cell is selected
hasFocus true if cell has focus
row the row of the cell to render
column the column of the cell to render
Returns
  • the default table cell renderer

public void invalidate ()

Overridden for performance reasons. See the Implementation Note for more information.

public boolean isOpaque ()

Overridden for performance reasons. See the Implementation Note for more information.

Returns
  • true if this component is completely opaque

public void repaint ()

Overridden for performance reasons. See the Implementation Note for more information.

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

Overridden for performance reasons. See the Implementation Note for more information.

Parameters
tm this parameter is not used
x the x value of the dirty region
y the y value of the dirty region
width the width of the dirty region
height the height of the dirty region

public void repaint (Rectangle r)

Overridden for performance reasons. See the Implementation Note for more information.

Parameters
r a Rectangle containing the dirty region

public void revalidate ()

Overridden for performance reasons. See the Implementation Note for more information.

public void setBackground (Color c)

Overrides JComponent.setBackground to assign the unselected-background color to the specified color.

Parameters
c set the background color to this value

public void setForeground (Color c)

Overrides JComponent.setForeground to assign the unselected-foreground color to the specified color.

Parameters
c set the foreground color to this value

public void updateUI ()

Notification from the UIManager that the look and feel [L&F] has changed. Replaces the current UI object with the latest version from the UIManager.

See Also

public void validate ()

Overridden for performance reasons. See the Implementation Note for more information.

Protected Methods

protected void firePropertyChange (String propertyName, Object oldValue, Object newValue)

Overridden for performance reasons. See the Implementation Note for more information.

Parameters
propertyName the property whose value has changed
oldValue the property's previous value
newValue the property's new value

protected void setValue (Object value)

Sets the String object for the cell being rendered to value.

Parameters
value the string value for this cell; if value is null it sets the text value to an empty string
See Also