Class AcroFields.Item

java.lang.Object
com.lowagie.text.pdf.AcroFields.Item
Enclosing class:
AcroFields

public static class AcroFields.Item extends Object
The field representations for retrieval and modification.
  • Field Details

    • WRITE_MERGED

      public static final int WRITE_MERGED
      writeToAll constant.
      Since:
      2.1.5
      See Also:
    • WRITE_WIDGET

      public static final int WRITE_WIDGET
      writeToAll and markUsed constant.
      Since:
      2.1.5
      See Also:
    • WRITE_VALUE

      public static final int WRITE_VALUE
      writeToAll and markUsed constant.
      Since:
      2.1.5
      See Also:
    • values

      An array of PdfDictionary where the value tag /V is present.
    • widgets

      An array of PdfDictionary with the widgets.
    • widgetRefs

      An array of PdfDictionary with the widget references.
    • merged

      An array of PdfDictionary with all the field and widget tags merged.
    • page

      An array of Integer with the page numbers where the widgets are displayed.
    • tabOrder

      ArrayList<Integer> tabOrder
      An array of Integer with the tab order of the field in the page.
    • fieldReference

      private PdfIndirectReference fieldReference
      The indirect reference of the item itself
  • Constructor Details

  • Method Details

    • writeToAll

      public void writeToAll(PdfName key, PdfObject value, int writeFlags)
      This function writes the given key/value pair to all the instances of merged, widget, and/or value, depending on the writeFlags setting
      Parameters:
      key - you'll never guess what this is for.
      value - if value is null, the key will be removed
      writeFlags - ORed together WRITE_* flags
      Since:
      2.1.5
    • markUsed

      public void markUsed(AcroFields parentFields, int writeFlags)
      Mark all the item dictionaries used matching the given flags
      Parameters:
      parentFields - parent fields
      writeFlags - WRITE_MERGED is ignored
      Since:
      2.1.5
    • size

      public int size()
      Preferred method of determining the number of instances of a given field.
      Returns:
      number of instances
      Since:
      2.1.5
    • remove

      public void remove(int killIdx)
      Remove the given instance from this item. It is possible to remove all instances using this function.
      Since:
      2.1.5
    • getValue

      public PdfDictionary getValue(int idx)
      Retrieve the value dictionary of the given instance
      Parameters:
      idx - instance index
      Returns:
      dictionary storing this instance's value. It may be shared across instances.
      Since:
      2.1.5
    • addValue

      void addValue(PdfDictionary value)
      Add a value dict to this Item
      Parameters:
      value - new value dictionary
      Since:
      2.1.5
    • getWidget

      public PdfDictionary getWidget(int idx)
      Retrieve the widget dictionary of the given instance
      Parameters:
      idx - instance index
      Returns:
      The dictionary found in the appropriate page's Annot array.
      Since:
      2.1.5
    • addWidget

      void addWidget(PdfDictionary widget)
      Add a widget dict to this Item
      Since:
      2.1.5
    • getWidgetRef

      public PdfIndirectReference getWidgetRef(int idx)
      Retrieve the reference to the given instance
      Parameters:
      idx - instance index
      Returns:
      reference to the given field instance
      Since:
      2.1.5
    • addWidgetRef

      void addWidgetRef(PdfIndirectReference widgRef)
      Add a widget ref to this Item
      Since:
      2.1.5
    • getMerged

      public PdfDictionary getMerged(int idx)
      Retrieve the merged dictionary for the given instance. The merged dictionary contains all the keys present in parent fields, though they may have been overwritten (or modified?) by children. Example: a merged radio field dict will contain /V
      Parameters:
      idx - instance index
      Returns:
      the merged dictionary for the given instance
      Since:
      2.1.5
    • addMerged

      void addMerged(PdfDictionary mergeDict)
      Adds a merged dictionary to this Item.
      Since:
      2.1.5
    • getPage

      public Integer getPage(int idx)
      Retrieve the page number of the given instance
      Parameters:
      idx - index
      Returns:
      remember, pages are "1-indexed", not "0-indexed" like field instances.
      Since:
      2.1.5
    • addPage

      void addPage(int pg)
      Adds a page to the current Item.
      Since:
      2.1.5
    • forcePage

      void forcePage(int idx, int pg)
      forces a page value into the Item.
      Since:
      2.1.5
    • getTabOrder

      public Integer getTabOrder(int idx)
      Gets the tabOrder.
      Parameters:
      idx - index
      Returns:
      tab index of the given field instance
      Since:
      2.1.5
    • addTabOrder

      void addTabOrder(int order)
      Adds a tab order value to this Item.
      Parameters:
      order - order for the tab
      Since:
      2.1.5
    • getFieldReference

      public PdfIndirectReference getFieldReference()
      Returns the indirect reference of the field itself
      Returns:
      PdfIndirectReferenceof the field