Class PDTextField
- java.lang.Object
-
- com.tom_roush.pdfbox.pdmodel.interactive.form.PDField
-
- com.tom_roush.pdfbox.pdmodel.interactive.form.PDTerminalField
-
- com.tom_roush.pdfbox.pdmodel.interactive.form.PDVariableText
-
- com.tom_roush.pdfbox.pdmodel.interactive.form.PDTextField
-
- All Implemented Interfaces:
COSObjectable
public final class PDTextField extends PDVariableText
A text field is a box or space for text fill-in data typically entered from a keyboard. The text may be restricted to a single line or may be permitted to span multiple lines
-
-
Field Summary
-
Fields inherited from class com.tom_roush.pdfbox.pdmodel.interactive.form.PDVariableText
QUADDING_CENTERED, QUADDING_LEFT, QUADDING_RIGHT
-
-
Constructor Summary
Constructors Constructor Description PDTextField(PDAcroForm acroForm)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description booleandoNotScroll()booleandoNotSpellCheck()StringgetDefaultValue()Returns the default value of this field, or an empty string.intgetMaxLen()Returns the maximum number of characters of the text field.StringgetValue()Returns the value of this field, or an empty string.StringgetValueAsString()Returns a string representation of the "V" entry, or an empty string.booleanisComb()booleanisFileSelect()booleanisMultiline()booleanisPassword()booleanisRichText()voidsetComb(boolean comb)Set the comb bit.voidsetDefaultValue(String value)Sets the default value of this field.voidsetDoNotScroll(boolean doNotScroll)Set the doNotScroll bit.voidsetDoNotSpellCheck(boolean doNotSpellCheck)Set the doNotSpellCheck bit.voidsetFileSelect(boolean fileSelect)Set the file select bit.voidsetMaxLen(int maxLen)Sets the maximum number of characters of the text field.voidsetMultiline(boolean multiline)Set the multiline bit.voidsetPassword(boolean password)Set the password bit.voidsetRichText(boolean richText)Set the richText bit.voidsetValue(String value)Sets the plain text value of this field.-
Methods inherited from class com.tom_roush.pdfbox.pdmodel.interactive.form.PDVariableText
getDefaultAppearance, getDefaultStyleString, getQ, getRichTextValue, getStringOrStream, setDefaultAppearance, setDefaultStyleString, setQ, setRichTextValue
-
Methods inherited from class com.tom_roush.pdfbox.pdmodel.interactive.form.PDTerminalField
applyChange, getFieldFlags, getFieldType, getWidget, getWidgets, importFDF, setActions, setWidgets
-
Methods inherited from class com.tom_roush.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
-
PDTextField
public PDTextField(PDAcroForm acroForm)
- Parameters:
acroForm- The acroform.- See Also:
PDField(PDAcroForm)
-
-
Method Detail
-
isMultiline
public boolean isMultiline()
- Returns:
- true if the field is multiline
-
setMultiline
public void setMultiline(boolean multiline)
Set the multiline bit.- Parameters:
multiline- The value for the multiline.
-
isPassword
public boolean isPassword()
- Returns:
- true if the field is a password field.
-
setPassword
public void setPassword(boolean password)
Set the password bit.- Parameters:
password- The value for the password.
-
isFileSelect
public boolean isFileSelect()
- Returns:
- true if the field is a file select field.
-
setFileSelect
public void setFileSelect(boolean fileSelect)
Set the file select bit.- Parameters:
fileSelect- The value for the fileSelect.
-
doNotSpellCheck
public boolean doNotSpellCheck()
- Returns:
- true if the field is not suppose to spell check.
-
setDoNotSpellCheck
public void setDoNotSpellCheck(boolean doNotSpellCheck)
Set the doNotSpellCheck bit.- Parameters:
doNotSpellCheck- The value for the doNotSpellCheck.
-
doNotScroll
public boolean doNotScroll()
- Returns:
- true if the field is not suppose to scroll.
-
setDoNotScroll
public void setDoNotScroll(boolean doNotScroll)
Set the doNotScroll bit.- Parameters:
doNotScroll- The value for the doNotScroll.
-
isComb
public boolean isComb()
- Returns:
- true if the field is not suppose to comb the text display.
-
setComb
public void setComb(boolean comb)
Set the comb bit.- Parameters:
comb- The value for the comb.
-
isRichText
public boolean isRichText()
- Returns:
- true if the field is a rich text field.
-
setRichText
public void setRichText(boolean richText)
Set the richText bit.- Parameters:
richText- The value for the richText.
-
getMaxLen
public int getMaxLen()
Returns the maximum number of characters of the text field.- Returns:
- the maximum number of characters, returns -1 if the value isn't present
-
setMaxLen
public void setMaxLen(int maxLen)
Sets the maximum number of characters of the text field.- Parameters:
maxLen- the maximum number of characters
-
setValue
public void setValue(String value) throws IOException
Sets the plain text value of this field. It also tries to update the visual appearance, unlessPDAcroForm.getNeedAppearances()is true.- Specified by:
setValuein classPDField- Parameters:
value- Plain text- Throws:
IOException- if the value could not be set
-
setDefaultValue
public void setDefaultValue(String value) throws IOException
Sets the default value of this field.- Parameters:
value- Plain text- Throws:
IOException- if the value could not be set
-
getValue
public String getValue()
Returns the value of this field, or an empty string.- Returns:
- A non-null string.
-
getDefaultValue
public String getDefaultValue()
Returns the default value of this field, or an empty string.- Returns:
- A non-null string.
-
getValueAsString
public String getValueAsString()
Description copied from class:PDFieldReturns a string representation of the "V" entry, or an empty string.- Specified by:
getValueAsStringin classPDField- Returns:
- The list of widget annotations.
-
-