org.jfree.report.elementfactory
Class DateFieldElementFactory

java.lang.Object
  org.jfree.report.elementfactory.ElementFactory
      org.jfree.report.elementfactory.TextElementFactory
          org.jfree.report.elementfactory.TextFieldElementFactory
              org.jfree.report.elementfactory.DateFieldElementFactory

public class DateFieldElementFactory

extends TextFieldElementFactory

The date format factory can be used to create date/time text elements. These text elements have special abilities to format date/time values.

Once the desired properties are set, the factory can be reused to create similiar text elements.

Author:

Thomas Morgner

Constructor Summary

DateFieldElementFactory()
Creates a new date field element factory.

Method Summary

static TextElement	createDateElement(java.lang.String name, java.awt.geom.Rectangle2D bounds, java.awt.Color paint, ElementAlignment alignment, ElementAlignment valign, FontDefinition font, java.lang.String nullString, java.text.DateFormat format, java.lang.String field) Creates a new TextElement containing a date filter structure.
static TextElement	createDateElement(java.lang.String name, java.awt.geom.Rectangle2D bounds, java.awt.Color paint, ElementAlignment alignment, ElementAlignment valign, FontDefinition font, java.lang.String nullString, java.lang.String format, java.lang.String field) Creates a new TextElement containing a date filter structure.
static TextElement	createDateElement(java.lang.String name, java.awt.geom.Rectangle2D bounds, java.awt.Color paint, ElementAlignment alignment, FontDefinition font, java.lang.String nullString, java.text.DateFormat format, java.lang.String field) Creates a new TextElement containing a date filter structure.
static TextElement	createDateElement(java.lang.String name, java.awt.geom.Rectangle2D bounds, java.awt.Color paint, ElementAlignment alignment, FontDefinition font, java.lang.String nullString, java.lang.String format, java.lang.String field) Creates a new TextElement containing a date filter structure.
Element	createElement() Creates the date text element based on the defined settings.
java.text.DateFormat	getFormat() Returns the date format used for all generated text elements.
java.lang.String	getFormatString() Returns the format string of the used date format.
void	setFormat(java.text.DateFormat format) Defines the date format used for all generated text elements.
void	setFormatString(java.lang.String formatString) Defines the format string of the used date format.

Methods inherited from class org.jfree.report.elementfactory.TextFieldElementFactory

createStringElement, createStringElement, getFieldname, getNullString, setFieldname, setNullString

Methods inherited from class org.jfree.report.elementfactory.TextElementFactory

applyStyle, getBold, getColor, getEmbedFont, getEncoding, getFontName, getFontSize, getHorizontalAlignment, getItalic, getLineHeight, getReservedLiteral, getStrikethrough, getTrimTextContent, getUnderline, getVerticalAlignment, setBold, setColor, setEmbedFont, setEncoding, setFontName, setFontSize, setHorizontalAlignment, setItalic, setLineHeight, setReservedLiteral, setStrikethrough, setTrimTextContent, setUnderline, setVerticalAlignment

Methods inherited from class org.jfree.report.elementfactory.ElementFactory

applyElementName, getAbsolutePosition, getDynamicHeight, getMaximumSize, getMinimumSize, getName, getPreferredSize, setAbsolutePosition, setDynamicHeight, setMaximumSize, setMinimumSize, setName, setPreferredSize

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DateFieldElementFactory

public DateFieldElementFactory()

Creates a new date field element factory.

Method Detail

getFormat

public java.text.DateFormat getFormat()

Returns the date format used for all generated text elements. The date format is shared among all generated elements.

Returns:

the date format used in this factory.

setFormat

public void setFormat(java.text.DateFormat format)

Defines the date format used for all generated text elements. The date format is shared among all generated elements.

Parameters:

format - the date format used in this factory.

getFormatString

public java.lang.String getFormatString()

Returns the format string of the used date format. This method will return null, if the current date format is no instance of SimpleDateFormat.

Returns:

the formatstring of the date format instance.

setFormatString

public void setFormatString(java.lang.String formatString)

Defines the format string of the used date format. This method will replace the date format instance of this factory. If the format string is null, the default format string of the current locale is used.

Parameters:

formatString - the formatstring of the date format instance.

createElement

public Element createElement()

Creates the date text element based on the defined settings. Undefined properties will not be set in the generated element.

Overrides:

createElement in class TextFieldElementFactory

Returns:

the generated date text element

See Also:

ElementFactory.createElement()

createDateElement

public static TextElement createDateElement(java.lang.String name,
                                            java.awt.geom.Rectangle2D bounds,
                                            java.awt.Color paint,
                                            ElementAlignment alignment,
                                            FontDefinition font,
                                            java.lang.String nullString,
                                            java.lang.String format,
                                            java.lang.String field)

Creates a new TextElement containing a date filter structure.

Parameters:

name - the name of the new element

bounds - the bounds of the new element

paint - the text color of this text element

alignment - the horizontal text alignment.

font - the font for this element

nullString - the text used when the value of this element is null

format - the SimpleDateFormat-formatstring used to format the date

field - the fieldname to retrieve values from

Returns:

a report element for displaying a java.util.Date value.

Throws:

java.lang.NullPointerException - if bounds, format or field are null

java.lang.IllegalArgumentException - if the given alignment is invalid

createDateElement

public static TextElement createDateElement(java.lang.String name,
                                            java.awt.geom.Rectangle2D bounds,
                                            java.awt.Color paint,
                                            ElementAlignment alignment,
                                            ElementAlignment valign,
                                            FontDefinition font,
                                            java.lang.String nullString,
                                            java.lang.String format,
                                            java.lang.String field)

Creates a new TextElement containing a date filter structure.

Parameters:

name - the name of the new element

bounds - the bounds of the new element

paint - the text color of this text element

alignment - the horizontal text alignment

valign - the vertical text alignment

font - the font for this element

nullString - the text used when the value of this element is null

format - the SimpleDateFormat-formatstring used to format the date

field - the fieldname to retrieve values from

Returns:

a report element for displaying a java.util.Date value.

Throws:

java.lang.NullPointerException - if bounds, format or field are null

java.lang.IllegalArgumentException - if the given alignment is invalid

createDateElement

public static TextElement createDateElement(java.lang.String name,
                                            java.awt.geom.Rectangle2D bounds,
                                            java.awt.Color paint,
                                            ElementAlignment alignment,
                                            FontDefinition font,
                                            java.lang.String nullString,
                                            java.text.DateFormat format,
                                            java.lang.String field)

Creates a new TextElement containing a date filter structure.

Parameters:

name - the name of the new element

bounds - the bounds of the new element

paint - the text color of this text element

alignment - the horizontal text alignment

font - the font for this element

nullString - the text used when the value of this element is null

format - the SimpleDateFormat used to format the date

field - the fieldname to retrieve values from

Returns:

a report element for displaying a java.util.Date value.

Throws:

java.lang.NullPointerException - if bounds, name, format or field are null

java.lang.IllegalArgumentException - if the given alignment is invalid

createDateElement

public static TextElement createDateElement(java.lang.String name,
                                            java.awt.geom.Rectangle2D bounds,
                                            java.awt.Color paint,
                                            ElementAlignment alignment,
                                            ElementAlignment valign,
                                            FontDefinition font,
                                            java.lang.String nullString,
                                            java.text.DateFormat format,
                                            java.lang.String field)

Creates a new TextElement containing a date filter structure.

Parameters:

name - the name of the new element

bounds - the bounds of the new element

paint - the text color of this text element

alignment - the horizontal text alignment.

valign - the vertical text alignment

font - the font for this element

nullString - the text used when the value of this element is null

format - the SimpleDateFormat used to format the date

field - the fieldname to retrieve values from

Returns:

a report element for displaying a java.util.Date value.

Throws:

java.lang.NullPointerException - if bounds, name, format or field are null

java.lang.IllegalArgumentException - if the given alignment is invalid