org.jdesktop.swingx.renderer
Class FormatStringValue

java.lang.Object
  extended by org.jdesktop.swingx.renderer.FormatStringValue
All Implemented Interfaces:
Serializable, StringValue

public class FormatStringValue
extends Object
implements StringValue

Base type for Format-backed StringValue. Has static defaults for Date and Number which use the locale-dependent default Formats as returned from xxFormat.getInstance().

This class is intended to ease the handling of formatted cell content. F.i. to show a list of Dates in the default Locale's FULL version and right align the text:


    StringValue stringValue = new FormatStringValue(
        DateFormat.getInstance(DateFormat.FULL));
    list.setCellRenderer(
        new DefaultListRenderer(stringValue, JLabel.RIGHT);  
 
PENDING: need to update on Locale change? How to detect? When?

See Also:
Serialized Form

Field Summary
protected  Format format
          the format used in creating the String representation.
 
Constructor Summary
FormatStringValue()
          Instantiates a formatted converter with null format.
FormatStringValue(Format format)
          Instantiates a formatted converter with the given Format.
 
Method Summary
 Format getFormat()
           
 String getString(Object value)
          Returns a string representation of the given value.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

format

protected Format format
the format used in creating the String representation.

Constructor Detail

FormatStringValue

public FormatStringValue()
Instantiates a formatted converter with null format.


FormatStringValue

public FormatStringValue(Format format)
Instantiates a formatted converter with the given Format.

Parameters:
format - the format to use in creating the String representation.
Method Detail

getFormat

public Format getFormat()
Returns:
the format used in creating the String representation.

getString

public String getString(Object value)
Returns a string representation of the given value.

PENDING JW: forgot - why not null return guaranteed?

Specified by:
getString in interface StringValue
Parameters:
value - the object to present as a string
Returns:
a string representation of the given value, guaranteed to be not null