Class PDSignatureField
- java.lang.Object
-
- org.apache.pdfbox.pdmodel.interactive.form.PDField
-
- org.apache.pdfbox.pdmodel.interactive.form.PDTerminalField
-
- org.apache.pdfbox.pdmodel.interactive.form.PDSignatureField
-
- All Implemented Interfaces:
COSObjectable
public class PDSignatureField extends PDTerminalField
A signature field is a form field that contains a digital signature.- Author:
- Ben Litchfield, Thomas Chojecki
-
-
Constructor Summary
Constructors Constructor Description PDSignatureField(PDAcroForm acroForm)
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description PDSignature
getDefaultValue()
Returns the default value, if any.PDSeedValue
getSeedValue()
(Optional; PDF 1.5) A seed value dictionary containing information that constrains the properties of a signature that is applied to the field.PDSignature
getSignature()
Get the signature dictionary.PDSignature
getValue()
Returns the signature contained in this field.java.lang.String
getValueAsString()
Returns a string representation of the "V" entry, or an empty string.void
setDefaultValue(PDSignature value)
Sets the default value of this field to be the given signature.void
setSeedValue(PDSeedValue sv)
(Optional; PDF 1.) A seed value dictionary containing information that constrains the properties of a signature that is applied to the field.void
setSignature(PDSignature value)
Deprecated.UsesetValue(PDSignature)
instead.void
setValue(java.lang.String value)
Sets the value of this field.void
setValue(PDSignature value)
Sets the value of this field to be the given signature.-
Methods inherited from class org.apache.pdfbox.pdmodel.interactive.form.PDTerminalField
applyChange, getFieldFlags, getFieldType, getWidget, getWidgets, importFDF, setActions, setWidgets
-
Methods inherited from class org.apache.pdfbox.pdmodel.interactive.form.PDField
getAcroForm, getActions, getAlternateFieldName, getCOSObject, getFullyQualifiedName, getInheritableAttribute, getMappingName, getParent, getPartialName, isNoExport, isReadOnly, isRequired, setAlternateFieldName, setFieldFlags, setMappingName, setNoExport, setPartialName, setReadOnly, setRequired, toString
-
-
-
-
Constructor Detail
-
PDSignatureField
public PDSignatureField(PDAcroForm acroForm) throws java.io.IOException
- Parameters:
acroForm
- The acroForm for this field.- Throws:
java.io.IOException
- If there is an error while resolving partial name for the signature field or getting the widget object.- See Also:
PDTerminalField(PDAcroForm)
-
-
Method Detail
-
setSignature
@Deprecated public void setSignature(PDSignature value) throws java.io.IOException
Deprecated.UsesetValue(PDSignature)
instead.Add a signature dictionary to the signature field.- Parameters:
value
- is the PDSignatureField- Throws:
java.io.IOException
-
getSignature
public PDSignature getSignature()
Get the signature dictionary.- Returns:
- the signature dictionary
-
setValue
public void setValue(PDSignature value) throws java.io.IOException
Sets the value of this field to be the given signature.- Parameters:
value
- is the PDSignatureField- Throws:
java.io.IOException
-
setValue
public void setValue(java.lang.String value) throws java.lang.UnsupportedOperationException
Sets the value of this field. This will throw an UnsupportedOperationException if used as the signature fields value can't be set using a String
-
setDefaultValue
public void setDefaultValue(PDSignature value) throws java.io.IOException
Sets the default value of this field to be the given signature.- Parameters:
value
- is the PDSignatureField- Throws:
java.io.IOException
-
getValue
public PDSignature getValue()
Returns the signature contained in this field.- Returns:
- A signature dictionary.
-
getDefaultValue
public PDSignature getDefaultValue()
Returns the default value, if any.- Returns:
- A signature dictionary.
-
getValueAsString
public java.lang.String getValueAsString()
Description copied from class:PDField
Returns a string representation of the "V" entry, or an empty string.- Specified by:
getValueAsString
in classPDField
- Returns:
- The list of widget annotations.
-
getSeedValue
public PDSeedValue getSeedValue()
(Optional; PDF 1.5) A seed value dictionary containing information that constrains the properties of a signature that is applied to the field.
- Returns:
- the seed value dictionary as PDSeedValue
-
setSeedValue
public void setSeedValue(PDSeedValue sv)
(Optional; PDF 1.) A seed value dictionary containing information that constrains the properties of a signature that is applied to the field.
- Parameters:
sv
- is the seed value dictionary as PDSeedValue
-
-