Package com.itextpdf.forms.fields

Class PdfSignatureFormField

java.lang.Object

com.itextpdf.kernel.pdf.PdfObjectWrapper<PdfDictionary>

com.itextpdf.forms.fields.AbstractPdfFormField

com.itextpdf.forms.fields.PdfFormField

com.itextpdf.forms.fields.PdfSignatureFormField

 public class PdfSignatureFormField extends PdfFormField 
      

An AcroForm field containing signature data.

Field Summary

Fields inherited from class com.itextpdf.forms.fields.PdfFormField

checkType, FF_MULTILINE, FF_NO_EXPORT, FF_PASSWORD, FF_READ_ONLY, FF_REQUIRED, form, img, text

Fields inherited from class com.itextpdf.forms.fields.AbstractPdfFormField

color, DEFAULT_FONT_SIZE, font, fontSize, MIN_FONT_SIZE, parent, pdfAConformanceLevel

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	PdfSignatureFormField(PdfWidgetAnnotation widget, PdfDocument pdfDocument)
protected	PdfSignatureFormField(PdfDictionary pdfObject)
protected	PdfSignatureFormField(PdfDocument pdfDocument)

Method Summary

Modifier and Type	Method	Description
PdfName	getFormType()	Returns Sig, the form type for signature form fields.
PdfSigFieldLock	getSigFieldLockDictionary()	Gets the PdfSigFieldLock, which contains fields that must be locked if the document is signed.
PdfSignatureFormField	setBackgroundLayer(PdfFormXObject n0)	Sets the background layer that is present when creating the signature field.
PdfSignatureFormField	setReuseAppearance(boolean reuseAppearance)	Indicates that the existing appearances needs to be reused as a background.
PdfSignatureFormField	setSignatureAppearanceLayer(PdfFormXObject n2)	Sets the signature appearance layer that contains information about the signature, e.g.
PdfSignatureFormField	setValue(PdfObject value)	Adds the signature to the signature field.

Methods inherited from class com.itextpdf.forms.fields.PdfFormField

addKid, addKid, addKid, getAdditionalAction, getAllChildFields, getAllChildFormFields, getAlternativeName, getAppearanceStates, getChildField, getChildFields, getChildFormAnnotations, getChildFormFields, getDefaultAppearance, getDefaultStyle, getDefaultValue, getDisplayValue, getFieldFlag, getFieldFlags, getFirstFormAnnotation, getFormFieldKeys, getFormType, getJustification, getKids, getMappingName, getOptions, getPartialFieldName, getRichText, getValue, getValueAsString, getWidgets, isFormField, isInReadingMode, isMultiline, isNoExport, isPassword, isReadOnly, isRequired, makeFieldFlag, makeFormField, makeFormFieldOrAnnotation, regenerateField, release, removeChild, removeChildren, setAdditionalAction, setAlternativeName, setCheckType, setColor, setDefaultStyle, setDefaultValue, setFieldFlag, setFieldFlag, setFieldFlags, setFieldName, setJustification, setMappingName, setNoExport, setOptions, setReadOnly, setRequired, setRichText, setValue, setValue, setValue, setValue, updateDefaultAppearance

Methods inherited from class com.itextpdf.forms.fields.AbstractPdfFormField

disableCurrentFieldRegeneration, disableFieldRegeneration, enableCurrentFieldRegeneration, enableFieldRegeneration, equals, getColor, getDocument, getFieldName, getFont, getFontSize, getParent, getParentField, getPdfAConformanceLevel, getPdfObject, hashCode, isFieldRegenerationEnabled, isTerminalFormField, isWrappedObjectMustBeIndirect, put, remove, setFont, setFontAndSize, setFontSize, setFontSize, setFontSizeAutoScale, setParent

Methods inherited from class com.itextpdf.kernel.pdf.PdfObjectWrapper

ensureObjectIsAddedToDocument, ensureUnderlyingObjectHasIndirectReference, flush, isFlushed, makeIndirect, makeIndirect, markObjectAsIndirect, setForbidRelease, setModified, setPdfObject, unsetForbidRelease

Methods inherited from class java.lang.Object

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

Constructor Details

PdfSignatureFormField

 protected PdfSignatureFormField 
             (PdfDocument pdfDocument) 
            

PdfSignatureFormField

 protected PdfSignatureFormField 
             (PdfWidgetAnnotation widget, PdfDocument pdfDocument) 
            

PdfSignatureFormField

 protected PdfSignatureFormField 
             (PdfDictionary pdfObject) 
            

Method Details

getFormType

 public PdfName getFormType() 
            

Returns Sig, the form type for signature form fields.

Overrides:

getFormType in class PdfFormField

Returns:

the form type, as a PdfName

setValue

 public PdfSignatureFormField setValue 
             (PdfObject value) 
            

Adds the signature to the signature field.

Parameters:

value - the signature to be contained in the signature field, or an indirect reference to it

Returns:

the edited field

getSigFieldLockDictionary

 public PdfSigFieldLock getSigFieldLockDictionary() 
            

Gets the PdfSigFieldLock, which contains fields that must be locked if the document is signed.

Returns:

a dictionary containing locked fields.

See Also:

• PdfSigFieldLock

setBackgroundLayer

 public PdfSignatureFormField setBackgroundLayer 
             (PdfFormXObject n0) 
            

Sets the background layer that is present when creating the signature field.

Parameters:

n0 - layer xObject.

Returns:

this same PdfSignatureFormField instance.

setSignatureAppearanceLayer

 public PdfSignatureFormField setSignatureAppearanceLayer 
             (PdfFormXObject n2) 
            

Sets the signature appearance layer that contains information about the signature, e.g. the line art for the handwritten signature, the text giving the signer’s name, date, reason, location and so on.

Parameters:

n2 - layer xObject.

Returns:

this same PdfSignatureFormField instance.

setReuseAppearance

 public PdfSignatureFormField setReuseAppearance 
             (boolean reuseAppearance) 
            

Indicates that the existing appearances needs to be reused as a background.

Parameters:

reuseAppearance - is an appearances reusing flag value to set.

Returns:

this same PdfSignatureFormField instance.