Class FDFField

  • All Implemented Interfaces:
    COSObjectable

    public class FDFField
    extends java.lang.Object
    implements COSObjectable
    This represents an FDF field that is part of the FDF document.
    • Constructor Detail

      • FDFField

        public FDFField()
        Default constructor.
      • FDFField

        public FDFField​(COSDictionary f)
        Constructor.
        Parameters:
        f - The FDF field.
      • FDFField

        public FDFField​(org.w3c.dom.Element fieldXML)
                 throws java.io.IOException
        This will create an FDF field from an XFDF XML document.
        Parameters:
        fieldXML - The XML document that contains the XFDF data.
        Throws:
        java.io.IOException - If there is an error reading from the dom.
    • Method Detail

      • writeXML

        public void writeXML​(java.io.Writer output)
                      throws java.io.IOException
        This will write this element as an XML document.
        Parameters:
        output - The stream to write the xml to.
        Throws:
        java.io.IOException - If there is an error writing the XML.
      • getCOSObject

        public COSDictionary getCOSObject()
        Convert this standard java object to a COS object.
        Specified by:
        getCOSObject in interface COSObjectable
        Returns:
        The cos object that matches this Java object.
      • getKids

        public java.util.List<FDFField> getKids()
        This will get the list of kids. This will return a list of FDFField objects. This will return null if the underlying list is null.
        Returns:
        The list of kids.
      • setKids

        public void setKids​(java.util.List<FDFField> kids)
        This will set the list of kids.
        Parameters:
        kids - A list of FDFField objects.
      • getPartialFieldName

        public java.lang.String getPartialFieldName()
        This will get the "T" entry in the field dictionary. A partial field name. Where the fully qualified field name is a concatenation of the parent's fully qualified field name and "." as a separator. For example
        Address.State
        Address.City
        Returns:
        The partial field name.
      • setPartialFieldName

        public void setPartialFieldName​(java.lang.String partial)
        This will set the partial field name.
        Parameters:
        partial - The partial field name.
      • getValue

        public java.lang.Object getValue()
                                  throws java.io.IOException
        This will get the value for the field. This will return type will either be
        String : Checkboxes, Radio Button, Textfields
        java.util.List of strings: Choice Field
        Returns:
        The value of the field.
        Throws:
        java.io.IOException - If there is an error getting the value.
      • getCOSValue

        public COSBase getCOSValue()
                            throws java.io.IOException
        Returns the COS value of this field.
        Returns:
        The COS value of the field.
        Throws:
        java.io.IOException - If there is an error getting the value.
      • setValue

        public void setValue​(java.lang.Object value)
                      throws java.io.IOException
        You should pass in a string, or a java.util.List of strings to set the value.
        Parameters:
        value - The value that should populate when imported.
        Throws:
        java.io.IOException - If there is an error setting the value.
      • setValue

        public void setValue​(COSBase value)
        Sets the COS value of this field.
        Parameters:
        value - COS value.
      • getFieldFlags

        public java.lang.Integer getFieldFlags()
        This will get the Ff entry of the cos dictionary. If it it not present then this method will return null.
        Returns:
        The field flags.
      • setFieldFlags

        public void setFieldFlags​(java.lang.Integer ff)
        This will get the field flags that are associated with this field. The Ff entry in the FDF field dictionary.
        Parameters:
        ff - The new value for the field flags.
      • setFieldFlags

        public void setFieldFlags​(int ff)
        This will get the field flags that are associated with this field. The Ff entry in the FDF field dictionary.
        Parameters:
        ff - The new value for the field flags.
      • getSetFieldFlags

        public java.lang.Integer getSetFieldFlags()
        This will get the SetFf entry of the cos dictionary. If it it not present then this method will return null.
        Returns:
        The field flags.
      • setSetFieldFlags

        public void setSetFieldFlags​(java.lang.Integer ff)
        This will get the field flags that are associated with this field. The SetFf entry in the FDF field dictionary.
        Parameters:
        ff - The new value for the "set field flags".
      • setSetFieldFlags

        public void setSetFieldFlags​(int ff)
        This will get the field flags that are associated with this field. The SetFf entry in the FDF field dictionary.
        Parameters:
        ff - The new value for the "set field flags".
      • getClearFieldFlags

        public java.lang.Integer getClearFieldFlags()
        This will get the ClrFf entry of the cos dictionary. If it it not present then this method will return null.
        Returns:
        The field flags.
      • setClearFieldFlags

        public void setClearFieldFlags​(java.lang.Integer ff)
        This will get the field flags that are associated with this field. The ClrFf entry in the FDF field dictionary.
        Parameters:
        ff - The new value for the "clear field flags".
      • setClearFieldFlags

        public void setClearFieldFlags​(int ff)
        This will get the field flags that are associated with this field. The ClrFf entry in the FDF field dictionary.
        Parameters:
        ff - The new value for the "clear field flags".
      • getWidgetFieldFlags

        public java.lang.Integer getWidgetFieldFlags()
        This will get the F entry of the cos dictionary. If it it not present then this method will return null.
        Returns:
        The widget field flags.
      • setWidgetFieldFlags

        public void setWidgetFieldFlags​(java.lang.Integer f)
        This will get the widget field flags that are associated with this field. The F entry in the FDF field dictionary.
        Parameters:
        f - The new value for the field flags.
      • setWidgetFieldFlags

        public void setWidgetFieldFlags​(int f)
        This will get the field flags that are associated with this field. The F entry in the FDF field dictionary.
        Parameters:
        f - The new value for the field flags.
      • getSetWidgetFieldFlags

        public java.lang.Integer getSetWidgetFieldFlags()
        This will get the SetF entry of the cos dictionary. If it it not present then this method will return null.
        Returns:
        The field flags.
      • setSetWidgetFieldFlags

        public void setSetWidgetFieldFlags​(java.lang.Integer ff)
        This will get the widget field flags that are associated with this field. The SetF entry in the FDF field dictionary.
        Parameters:
        ff - The new value for the "set widget field flags".
      • setSetWidgetFieldFlags

        public void setSetWidgetFieldFlags​(int ff)
        This will get the widget field flags that are associated with this field. The SetF entry in the FDF field dictionary.
        Parameters:
        ff - The new value for the "set widget field flags".
      • getClearWidgetFieldFlags

        public java.lang.Integer getClearWidgetFieldFlags()
        This will get the ClrF entry of the cos dictionary. If it it not present then this method will return null.
        Returns:
        The widget field flags.
      • setClearWidgetFieldFlags

        public void setClearWidgetFieldFlags​(java.lang.Integer ff)
        This will get the field flags that are associated with this field. The ClrF entry in the FDF field dictionary.
        Parameters:
        ff - The new value for the "clear widget field flags".
      • setClearWidgetFieldFlags

        public void setClearWidgetFieldFlags​(int ff)
        This will get the field flags that are associated with this field. The ClrF entry in the FDF field dictionary.
        Parameters:
        ff - The new value for the "clear field flags".
      • getAppearanceDictionary

        public PDAppearanceDictionary getAppearanceDictionary()
        This will get the appearance dictionary that specifies the appearance of a pushbutton field.
        Returns:
        The AP entry of this dictionary.
      • setAppearanceDictionary

        public void setAppearanceDictionary​(PDAppearanceDictionary ap)
        This will set the appearance dictionary.
        Parameters:
        ap - The appearance dictionary.
      • getAppearanceStreamReference

        public FDFNamedPageReference getAppearanceStreamReference()
        This will get named page references..
        Returns:
        The named page references.
      • setAppearanceStreamReference

        public void setAppearanceStreamReference​(FDFNamedPageReference ref)
        This will set the named page references.
        Parameters:
        ref - The named page references.
      • getIconFit

        public FDFIconFit getIconFit()
        This will get the icon fit that is associated with this field.
        Returns:
        The IF entry.
      • setIconFit

        public void setIconFit​(FDFIconFit fit)
        This will set the icon fit entry.
        Parameters:
        fit - The icon fit object.
      • getOptions

        public java.util.List<java.lang.Object> getOptions()
        This will return a list of options for a choice field. The value in the list will be 1 of 2 types. java.lang.String or FDFOptionElement.
        Returns:
        A list of all options.
      • setOptions

        public void setOptions​(java.util.List<java.lang.Object> options)
        This will set the options for the choice field. The objects in the list should either be java.lang.String or FDFOptionElement.
        Parameters:
        options - The options to set.
      • getAction

        public PDAction getAction()
        This will get the action that is associated with this field.
        Returns:
        The A entry in the field dictionary.
      • setAction

        public void setAction​(PDAction a)
        This will set the action that is associated with this field.
        Parameters:
        a - The new action.
      • getAdditionalActions

        public PDAdditionalActions getAdditionalActions()
        This will get a list of additional actions that will get executed based on events.
        Returns:
        The AA entry in this field dictionary.
      • setAdditionalActions

        public void setAdditionalActions​(PDAdditionalActions aa)
        This will set the additional actions that are associated with this field.
        Parameters:
        aa - The additional actions.
      • getRichText

        public java.lang.String getRichText()
        This will set the rich text that is associated with this field.
        Returns:
        The rich text XHTML stream.
      • setRichText

        public void setRichText​(COSString rv)
        This will set the rich text value.
        Parameters:
        rv - The rich text value for the stream.
      • setRichText

        public void setRichText​(COSStream rv)
        This will set the rich text value.
        Parameters:
        rv - The rich text value for the stream.
      • escapeXML

        private java.lang.String escapeXML​(java.lang.String input)
        Escape special characters.
        Parameters:
        input - the string to be escaped
        Returns:
        the resulting string