Class 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 Detail

      • DateFieldElementFactory

        public DateFieldElementFactory()
        Creates a new date field element factory.
    • Method Detail

      • getExcelCellFormat

        public String getExcelCellFormat()
        Returns the excel export cell format.
        Returns:
        the excel cell format.
      • setExcelCellFormat

        public void setExcelCellFormat​(String excelCellFormat)
        Defines a special cell format that should be used when exporting the report into Excel workbooks.
        Parameters:
        excelCellFormat - the excel cell format
      • getFormat

        public 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​(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 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​(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.
      • createDateElement

        public static Element createDateElement​(String name,
                                                Rectangle2D bounds,
                                                Color paint,
                                                ElementAlignment alignment,
                                                FontDefinition font,
                                                String nullString,
                                                String format,
                                                String field)
        Deprecated.
        Use a more fine-grained approach to define this element by using the element-factory directly.
        Creates a new Element 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:
        NullPointerException - if bounds, format or field are null
        IllegalArgumentException - if the given alignment is invalid
      • createDateElement

        public static Element createDateElement​(String name,
                                                Rectangle2D bounds,
                                                Color paint,
                                                ElementAlignment alignment,
                                                ElementAlignment valign,
                                                FontDefinition font,
                                                String nullString,
                                                String format,
                                                String field)
        Deprecated.
        Use a more fine-grained approach to define this element by using the element-factory directly.
        Creates a new Element 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:
        NullPointerException - if bounds, format or field are null
        IllegalArgumentException - if the given alignment is invalid
      • createDateElement

        public static Element createDateElement​(String name,
                                                Rectangle2D bounds,
                                                Color paint,
                                                ElementAlignment alignment,
                                                FontDefinition font,
                                                String nullString,
                                                DateFormat format,
                                                String field)
        Deprecated.
        Use a more fine-grained approach to define this element by using the element-factory directly.
        Creates a new Element 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:
        NullPointerException - if bounds, name, format or field are null
        IllegalArgumentException - if the given alignment is invalid
      • createDateElement

        public static Element createDateElement​(String name,
                                                Rectangle2D bounds,
                                                Color paint,
                                                ElementAlignment alignment,
                                                ElementAlignment valign,
                                                FontDefinition font,
                                                String nullString,
                                                DateFormat format,
                                                String field)
        Deprecated.
        Use a more fine-grained approach to define this element by using the element-factory directly.
        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:
        NullPointerException - if bounds, name, format or field are null
        IllegalArgumentException - if the given alignment is invalid