Package com.lowagie.text.pdf
Class AcroFields.Item
- java.lang.Object
-
- com.lowagie.text.pdf.AcroFields.Item
-
- Enclosing class:
- AcroFields
public static class AcroFields.Item extends java.lang.Object
The field representations for retrieval and modification.
-
-
Field Summary
Fields Modifier and Type Field Description private PdfIndirectReference
fieldReference
The indirect reference of the item itself(package private) java.util.ArrayList<PdfDictionary>
merged
An array ofPdfDictionary
with all the field and widget tags merged.(package private) java.util.ArrayList<java.lang.Integer>
page
An array ofInteger
with the page numbers where the widgets are displayed.(package private) java.util.ArrayList<java.lang.Integer>
tabOrder
An array ofInteger
with the tab order of the field in the page.(package private) java.util.ArrayList<PdfDictionary>
values
An array ofPdfDictionary
where the value tag /V is present.(package private) java.util.ArrayList<PdfIndirectReference>
widgetRefs
An array ofPdfDictionary
with the widget references.(package private) java.util.ArrayList<PdfDictionary>
widgets
An array ofPdfDictionary
with the widgets.static int
WRITE_MERGED
writeToAll
constant.static int
WRITE_VALUE
writeToAll
andmarkUsed
constant.static int
WRITE_WIDGET
writeToAll
andmarkUsed
constant.
-
Constructor Summary
Constructors Constructor Description Item(PdfIndirectReference ref)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description (package private) void
addMerged(PdfDictionary mergeDict)
Adds a merged dictionary to this Item.(package private) void
addPage(int pg)
Adds a page to the current Item.(package private) void
addTabOrder(int order)
Adds a tab order value to this Item.(package private) void
addValue(PdfDictionary value)
Add a value dict to this Item(package private) void
addWidget(PdfDictionary widget)
Add a widget dict to this Item(package private) void
addWidgetRef(PdfIndirectReference widgRef)
Add a widget ref to this Item(package private) void
forcePage(int idx, int pg)
forces a page value into the Item.PdfIndirectReference
getFieldReference()
Returns the indirect reference of the field itselfPdfDictionary
getMerged(int idx)
Retrieve the merged dictionary for the given instance.java.lang.Integer
getPage(int idx)
Retrieve the page number of the given instancejava.lang.Integer
getTabOrder(int idx)
Gets the tabOrder.PdfDictionary
getValue(int idx)
Retrieve the value dictionary of the given instancePdfDictionary
getWidget(int idx)
Retrieve the widget dictionary of the given instancePdfIndirectReference
getWidgetRef(int idx)
Retrieve the reference to the given instancevoid
markUsed(AcroFields parentFields, int writeFlags)
Mark all the item dictionaries used matching the given flagsvoid
remove(int killIdx)
Remove the given instance from this item.int
size()
Preferred method of determining the number of instances of a given field.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 thewriteFlags
setting
-
-
-
Field Detail
-
WRITE_MERGED
public static final int WRITE_MERGED
writeToAll
constant.- Since:
- 2.1.5
- See Also:
- Constant Field Values
-
WRITE_WIDGET
public static final int WRITE_WIDGET
writeToAll
andmarkUsed
constant.- Since:
- 2.1.5
- See Also:
- Constant Field Values
-
WRITE_VALUE
public static final int WRITE_VALUE
writeToAll
andmarkUsed
constant.- Since:
- 2.1.5
- See Also:
- Constant Field Values
-
values
java.util.ArrayList<PdfDictionary> values
An array ofPdfDictionary
where the value tag /V is present.
-
widgets
java.util.ArrayList<PdfDictionary> widgets
An array ofPdfDictionary
with the widgets.
-
widgetRefs
java.util.ArrayList<PdfIndirectReference> widgetRefs
An array ofPdfDictionary
with the widget references.
-
merged
java.util.ArrayList<PdfDictionary> merged
An array ofPdfDictionary
with all the field and widget tags merged.
-
page
java.util.ArrayList<java.lang.Integer> page
An array ofInteger
with the page numbers where the widgets are displayed.
-
tabOrder
java.util.ArrayList<java.lang.Integer> tabOrder
An array ofInteger
with the tab order of the field in the page.
-
fieldReference
private PdfIndirectReference fieldReference
The indirect reference of the item itself
-
-
Constructor Detail
-
Item
public Item(PdfIndirectReference ref)
-
-
Method Detail
-
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 thewriteFlags
setting- Parameters:
key
- you'll never guess what this is for.value
- if value is null, the key will be removedwriteFlags
- 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:
writeFlags
- WRITE_MERGED is ignoredparentFields
- parent fields- 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 java.lang.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 java.lang.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
-
-