iText 8.0.5 API
iText.Forms.Fields.PdfTextFormField Class Reference

An AcroForm field containing textual data. More...

Inheritance diagram for iText.Forms.Fields.PdfTextFormField:
iText.Forms.Fields.PdfFormField iText.Forms.Fields.AbstractPdfFormField iText.Kernel.Pdf.PdfObjectWrapper< PdfDictionary >

Public Member Functions

override PdfName  GetFormType ()
  Returns Tx, the form type for textual form fields. More...
 
virtual iText.Forms.Fields.PdfTextFormField  SetMultiline (bool multiline)
  If true, the field can contain multiple lines of text; if false, the field?s text is restricted to a single line. More...
 
virtual iText.Forms.Fields.PdfTextFormField  SetPassword (bool password)
  If true, the field is intended for entering a secure password that should not be echoed visibly to the screen. More...
 
virtual bool  IsFileSelect ()
  If true, the text entered in the field represents the pathname of a file whose contents are to be submitted as the value of the field. More...
 
virtual iText.Forms.Fields.PdfTextFormField  SetFileSelect (bool fileSelect)
  If true, the text entered in the field represents the pathname of a file whose contents are to be submitted as the value of the field. More...
 
virtual bool  IsSpellCheck ()
  If true, text entered in the field is spell-checked. More...
 
virtual iText.Forms.Fields.PdfTextFormField  SetSpellCheck (bool spellCheck)
  If true, text entered in the field is spell-checked. More...
 
virtual bool  IsScroll ()
  If true, the field scrolls (horizontally for single-line fields, vertically for multiple-line fields) to accommodate more text than fits within its annotation rectangle. More...
 
virtual iText.Forms.Fields.PdfTextFormField  SetScroll (bool scroll)
  If true, the field scrolls (horizontally for single-line fields, vertically for multiple-line fields) to accommodate more text than fits within its annotation rectangle. More...
 
virtual bool  IsComb ()
  Meaningful only if the MaxLen entry is present in the text field dictionary and if the Multiline, Password, and FileSelect flags are clear. More...
 
virtual iText.Forms.Fields.PdfTextFormField  SetComb (bool comb)
  Meaningful only if the MaxLen entry is present in the text field dictionary and if the Multiline, Password, and FileSelect flags are clear. More...
 
virtual bool  IsRichText ()
  If true, the value of this field should be represented as a rich text string. More...
 
virtual iText.Forms.Fields.PdfTextFormField  SetRichText (bool richText)
  If true, the value of this field should be represented as a rich text string. More...
 
virtual int  GetMaxLen ()
  Gets the maximum length of the field's text, in characters. More...
 
virtual iText.Forms.Fields.PdfTextFormField  SetMaxLen (int maxLen)
  Sets the maximum length of the field's text, in characters. More...
 
- Public Member Functions inherited from iText.Forms.Fields.PdfFormField
  PdfFormField (PdfDictionary pdfObject)
  Creates a form field as a wrapper object around a iText.Kernel.Pdf.PdfDictionary. More...
 
virtual iText.Forms.Fields.PdfFormField  SetValue (String value)
  Sets a value to the field and generating field appearance if needed. More...
 
virtual iText.Forms.Fields.PdfFormField  SetValue (String value, bool generateAppearance)
  Sets a value to the field (and fields with the same names) and generates field appearance if needed. More...
 
virtual iText.Forms.Fields.PdfFormField  SetValue (String value, PdfFont font, float fontSize)
  Set text field value with given font and size. More...
 
virtual iText.Forms.Fields.PdfFormField  SetValue (String value, String displayValue)
  Sets the field value and the display string. More...
 
virtual void  RemoveChild (AbstractPdfFormField fieldName)
  Removes the childField object of this field. More...
 
virtual void  RemoveChildren ()
  Removes all children from the current field. More...
 
virtual PdfArray  GetKids ()
  Gets the kids of this object. More...
 
virtual IList< AbstractPdfFormField GetChildFields ()
  Gets the childFields of this object. More...
 
virtual IList< iText.Forms.Fields.PdfFormField GetChildFormFields ()
  Gets all child form fields of this form field. More...
 
virtual IList< iText.Forms.Fields.PdfFormField GetAllChildFormFields ()
  Gets all childFields of this object, including the children of the children but not annotations. More...
 
virtual IList< AbstractPdfFormField GetAllChildFields ()
  Gets all childFields of this object, including the children of the children. More...
 
virtual iText.Forms.Fields.PdfFormField  GetChildField (String fieldName)
  Gets the child field of form field. More...
 
virtual iText.Forms.Fields.PdfFormField  AddKid (AbstractPdfFormField kid)
  Adds a new kid to the Kids array property from a AbstractPdfFormField. More...
 
virtual iText.Forms.Fields.PdfFormField  AddKid (AbstractPdfFormField kid, bool throwExceptionOnError)
  Adds a new kid to the Kids array property from a AbstractPdfFormField. More...
 
virtual iText.Forms.Fields.PdfFormField  AddKid (PdfWidgetAnnotation kid)
  Adds a new kid to the Kids array property from a iText.Kernel.Pdf.Annot.PdfWidgetAnnotation. More...
 
virtual iText.Forms.Fields.PdfFormField  SetFieldName (String name)
  Changes the name of the field to the specified value. More...
 
virtual PdfString  GetPartialFieldName ()
  Gets the current field partial name. More...
 
virtual iText.Forms.Fields.PdfFormField  SetAlternativeName (String name)
  Changes the alternate name of the field to the specified value. More...
 
virtual PdfString  GetAlternativeName ()
  Gets the current alternate name. More...
 
virtual iText.Forms.Fields.PdfFormField  SetMappingName (String name)
  Changes the mapping name of the field to the specified value. More...
 
virtual PdfString  GetMappingName ()
  Gets the current mapping name. More...
 
virtual bool  GetFieldFlag (int flag)
  Checks whether a certain flag, or any of a combination of flags, is set for this form field. More...
 
virtual iText.Forms.Fields.PdfFormField  SetFieldFlag (int flag)
  Adds a flag, or combination of flags, for the form field. More...
 
virtual iText.Forms.Fields.PdfFormField  SetFieldFlag (int flag, bool value)
  Adds or removes a flag, or combination of flags, for the form field. More...
 
virtual bool  IsMultiline ()
  If true, the field can contain multiple lines of text; if false, the field's text is restricted to a single line. More...
 
virtual bool  IsPassword ()
  If true, the field is intended for entering a secure password that should not be echoed visibly to the screen. More...
 
virtual iText.Forms.Fields.PdfFormField  SetFieldFlags (int flags)
  Sets a flag, or combination of flags, for the form field. More...
 
virtual int  GetFieldFlags ()
  Gets the current list of PDF form field flags. More...
 
virtual PdfObject  GetValue ()
  Gets the current value contained in the form field. More...
 
virtual String  GetValueAsString ()
  Gets the current value contained in the form field. More...
 
virtual String  GetDisplayValue ()
  Gets the current display value of the form field. More...
 
virtual iText.Forms.Fields.PdfFormField  SetDefaultValue (PdfObject value)
  Sets the default fallback value for the form field. More...
 
virtual PdfObject  GetDefaultValue ()
  Gets the default fallback value for the form field. More...
 
virtual iText.Forms.Fields.PdfFormField  SetAdditionalAction (PdfName key, PdfAction action)
  Sets an additional action for the form field. More...
 
virtual PdfDictionary  GetAdditionalAction ()
  Gets the currently additional action dictionary for the form field. More...
 
virtual iText.Forms.Fields.PdfFormField  SetOptions (PdfArray options)
  Sets options for the form field. More...
 
virtual PdfArray  GetOptions ()
  Gets options for the form field. More...
 
virtual IList< PdfWidgetAnnotation GetWidgets ()
  Gets all iText.Kernel.Pdf.Annot.PdfWidgetAnnotation that its children refer to. More...
 
virtual IList< PdfFormAnnotation GetChildFormAnnotations ()
  Gets all child form field's annotations PdfFormAnnotation of this form field. More...
 
virtual PdfFormAnnotation  GetFirstFormAnnotation ()
  Gets a single child form field's annotation PdfFormAnnotation. More...
 
override PdfString  GetDefaultAppearance ()
  Gets default appearance string containing a sequence of valid page-content graphics or text state operators that define such properties as the field's text size and color. More...
 
virtual void  UpdateDefaultAppearance ()
  Updates DA for Variable text, Push button and choice form fields. More...
 
virtual ? TextAlignment  GetJustification ()
  Gets a code specifying the form of quadding (justification) to be used in displaying the text: 0 Left-justified 1 Centered 2 Right-justified More...
 
virtual iText.Forms.Fields.PdfFormField  SetJustification (TextAlignment? justification)
  Sets a code specifying the form of quadding (justification) to be used in displaying the text: 0 Left-justified 1 Centered 2 Right-justified More...
 
virtual PdfString  GetDefaultStyle ()
  Gets a default style string, as described in "Rich Text Strings" section of Pdf spec. More...
 
virtual iText.Forms.Fields.PdfFormField  SetDefaultStyle (PdfString defaultStyleString)
  Sets a default style string, as described in "Rich Text Strings" section of Pdf spec. More...
 
virtual PdfObject  GetRichText ()
  Gets a rich text string, as described in "Rich Text Strings" section of Pdf spec. More...
 
virtual iText.Forms.Fields.PdfFormField  SetRichText (PdfObject richText)
  Sets a rich text string, as described in "Rich Text Strings" section of Pdf spec. More...
 
virtual iText.Forms.Fields.PdfFormField  SetCheckType (CheckBoxType checkType)
  Changes the type of graphical marker used to mark a checkbox as 'on'. More...
 
override bool  RegenerateField ()
  This method regenerates appearance stream of the field. More...
 
virtual iText.Forms.Fields.PdfFormField  SetReadOnly (bool readOnly)
  Sets the ReadOnly flag, specifying whether or not the field can be changed. More...
 
virtual bool  IsReadOnly ()
  Gets the ReadOnly flag, specifying whether or not the field can be changed. More...
 
virtual iText.Forms.Fields.PdfFormField  SetRequired (bool required)
  Sets the Required flag, specifying whether or not the field must be filled in. More...
 
virtual bool  IsRequired ()
  Gets the Required flag, specifying whether or not the field must be filled in. More...
 
virtual iText.Forms.Fields.PdfFormField  SetNoExport (bool noExport)
  Sets the NoExport flag, specifying whether or not exporting is forbidden. More...
 
virtual bool  IsNoExport ()
  Gets the NoExport attribute. More...
 
virtual bool  IsInReadingMode ()
  Checks if the document that contains the field is created in reading mode. More...
 
override String[]  GetAppearanceStates ()
  Gets the appearance state names. More...
 
override void  Release ()
  Releases underlying pdf object and other pdf entities used by wrapper. More...
 
override AbstractPdfFormField  SetColor (Color color)
  Sets the text color and regenerates appearance stream. More...
 
- Public Member Functions inherited from iText.Forms.Fields.AbstractPdfFormField
override PdfDictionary  GetPdfObject ()
  Gets the wrapped dictionary. More...
 
virtual void  SetParent (PdfFormField parent)
  Sets a parent PdfFormField for the current object. More...
 
virtual PdfDictionary  GetParent ()
  Gets the parent dictionary. More...
 
virtual PdfFormField  GetParentField ()
  Gets the parent field. More...
 
virtual PdfString  GetFieldName ()
  Gets the current field name. More...
 
virtual float  GetFontSize ()
  Gets the current fontSize of the form field. More...
 
virtual PdfFont  GetFont ()
  Gets the current font of the form field. More...
 
virtual Color  GetColor ()
  Gets the current color of the form field. More...
 
virtual PdfAConformanceLevel  GetPdfAConformanceLevel ()
  Gets the declared conformance level. More...
 
virtual IConformanceLevel  GetPdfConformanceLevel ()
  Gets the declared conformance level. More...
 
virtual void  DisableFieldRegeneration ()
  This method disables regeneration of the field and its children appearance stream. More...
 
virtual void  EnableFieldRegeneration ()
  This method enables regeneration of the field appearance stream. More...
 
virtual void  DisableCurrentFieldRegeneration ()
  This method disables regeneration of the current field appearance stream. More...
 
virtual void  EnableCurrentFieldRegeneration ()
  This method enables regeneration of the current field appearance stream and regenerates it. More...
 
virtual bool  IsFieldRegenerationEnabled ()
  This method checks if field appearance stream regeneration is enabled. More...
 
virtual iText.Forms.Fields.AbstractPdfFormField  Put (PdfName key, PdfObject value)
  Inserts the value into the iText.Kernel.Pdf.PdfDictionary of this field and associates it with the specified key. More...
 
virtual iText.Forms.Fields.AbstractPdfFormField  Remove (PdfName key)
  Removes the specified key from the iText.Kernel.Pdf.PdfDictionary of this field. More...
 
virtual PdfDocument  GetDocument ()
  Gets the iText.Kernel.Pdf.PdfDocument that owns that form field. More...
 
virtual iText.Forms.Fields.AbstractPdfFormField  SetFont (PdfFont font)
  Basic setter for the font property. More...
 
virtual iText.Forms.Fields.AbstractPdfFormField  SetFontSize (float fontSize)
  Basic setter for the fontSize property. More...
 
virtual iText.Forms.Fields.AbstractPdfFormField  SetFontSize (int fontSize)
  Basic setter for the fontSize property. More...
 
virtual iText.Forms.Fields.AbstractPdfFormField  SetFontSizeAutoScale ()
  Sets zero font size which will be interpreted as auto-size according to ISO 32000-1, 12.7.3.3. More...
 
virtual iText.Forms.Fields.AbstractPdfFormField  SetFontAndSize (PdfFont font, float fontSize)
  Combined setter for the font and fontSize properties. More...
 
virtual bool  IsTerminalFormField ()
  Determines whether current form field is terminal or not. More...
 
override bool  Equals (Object o)
  Indicate whether some other object is "equal to" this one. More...
 
override int  GetHashCode ()
  Generate a hash code for this object. More...
 
- Public Member Functions inherited from iText.Kernel.Pdf.PdfObjectWrapper< PdfDictionary >
virtual iText.Kernel.Pdf.PdfObjectWrapper< T >  MakeIndirect (PdfDocument document, PdfIndirectReference reference)
  Marks object behind wrapper to be saved as indirect. More...
 
virtual iText.Kernel.Pdf.PdfObjectWrapper< T >  MakeIndirect (PdfDocument document)
  Marks object behind wrapper to be saved as indirect. More...
 
virtual iText.Kernel.Pdf.PdfObjectWrapper< T >  SetModified ()
 
virtual void  Flush ()
 
virtual bool  IsFlushed ()
 

Static Public Attributes

static readonly int  FF_FILE_SELECT = MakeFieldFlag(21)
  constant which determines whether field currently represents a path. More...
 
static readonly int  FF_DO_NOT_SPELL_CHECK = MakeFieldFlag(23)
  constant which determines whether spell-checking is currently enabled More...
 
static readonly int  FF_DO_NOT_SCROLL = MakeFieldFlag(24)
  constant which determines whether longer texts are currently allowed. More...
 
static readonly int  FF_COMB = MakeFieldFlag(25)
  constant which determines maximum length of the field's text. More...
 
static readonly int  FF_RICH_TEXT = MakeFieldFlag(26)
  constant which determines whether text is currently represented as rich text. More...
 
- Static Public Attributes inherited from iText.Forms.Fields.PdfFormField
static readonly int  FF_MULTILINE = MakeFieldFlag(13)
  Flag that designates, if set, that the field can contain multiple lines of text. More...
 
static readonly int  FF_PASSWORD = MakeFieldFlag(14)
  Flag that designates, if set, that the field's contents must be obfuscated. More...
 
static readonly int  FF_READ_ONLY = MakeFieldFlag(1)
  The ReadOnly flag, which specifies whether or not the field can be changed. More...
 
static readonly int  FF_REQUIRED = MakeFieldFlag(2)
  The Required flag, which specifies whether or not the field must be filled in. More...
 
static readonly int  FF_NO_EXPORT = MakeFieldFlag(3)
  The NoExport flag, which specifies whether or not exporting is forbidden. More...
 
- Static Public Attributes inherited from iText.Forms.Fields.AbstractPdfFormField
const int  DEFAULT_FONT_SIZE = 12
  Size of text in form fields when font size is not explicitly set. More...
 
const int  MIN_FONT_SIZE = 4
  Minimal size of text in form fields. More...
 

Package Functions

  PdfTextFormField (PdfDocument pdfDocument)
  Creates a minimal PdfTextFormField. More...
 
  PdfTextFormField (PdfWidgetAnnotation widget, PdfDocument pdfDocument)
  Creates a text form field as a parent of a iText.Kernel.Pdf.Annot.PdfWidgetAnnotation. More...
 
  PdfTextFormField (PdfDictionary pdfObject)
  Creates a text form field as a wrapper object around a iText.Kernel.Pdf.PdfDictionary. More...
 
- Package Functions inherited from iText.Forms.Fields.PdfFormField
  PdfFormField (PdfDocument pdfDocument)
  Creates a minimal PdfFormField. More...
 
  PdfFormField (PdfWidgetAnnotation widget, PdfDocument pdfDocument)
  Creates a form field as a parent of a iText.Kernel.Pdf.Annot.PdfWidgetAnnotation. More...
 
- Package Functions inherited from iText.Forms.Fields.AbstractPdfFormField
  AbstractPdfFormField (PdfDictionary pdfObject)
  Creates a form field as a wrapper object around a iText.Kernel.Pdf.PdfDictionary. More...
 
- Package Functions inherited from iText.Kernel.Pdf.PdfObjectWrapper< PdfDictionary >
  PdfObjectWrapper (T pdfObject)
 
virtual void  SetPdfObject (T pdfObject)
 
virtual void  SetForbidRelease ()
 
virtual void  UnsetForbidRelease ()
 
virtual void  EnsureUnderlyingObjectHasIndirectReference ()
 

Additional Inherited Members

- Static Public Member Functions inherited from iText.Forms.Fields.PdfFormField
static iText.Forms.Fields.PdfFormField  MakeFormField (PdfObject pdfObject, PdfDocument document)
  Creates a (subtype of) PdfFormField object. More...
 
static AbstractPdfFormField  MakeFormFieldOrAnnotation (PdfObject pdfObject, PdfDocument document)
  Creates a (subtype of) PdfFormField or PdfFormAnnotation object depending on pdfObject. More...
 
static int  MakeFieldFlag (int bitPosition)
  Makes a field flag by bit position. More...
 
static bool  IsFormField (PdfDictionary dict)
  Checks if dictionary contains any of the form field keys. More...
 
static ICollection< PdfName GetFormFieldKeys ()
  Gets a set of all possible form field keys except PdfName.Parent. More...
 
static PdfName  GetFormType (PdfDictionary fieldDict)
  Returns the type of the form field dictionary, or of the parent object. More...
 
- Protected Member Functions inherited from iText.Forms.Fields.AbstractPdfFormField
override bool  IsWrappedObjectMustBeIndirect ()
  Defines if the object behind this wrapper must be an indirect object in the resultant document. More...
 
- Static Package Functions inherited from iText.Kernel.Pdf.PdfObjectWrapper< PdfDictionary >
static void  MarkObjectAsIndirect (PdfObject pdfObject)
 
static void  EnsureObjectIsAddedToDocument (PdfObject @object)
  Some wrappers use object's indirect reference to obtain the PdfDocument to which the object belongs to. More...
 
- Package Attributes inherited from iText.Forms.Fields.PdfFormField
String  text
 
ImageData  img
 
PdfFormXObject  form
 
NullableContainer< CheckBoxType checkType = null
 
- Package Attributes inherited from iText.Forms.Fields.AbstractPdfFormField
PdfFont  font
 
float  fontSize = -1
 
Color  color
 
PdfAConformanceLevel  pdfAConformanceLevel
 
IConformanceLevel  pdfConformanceLevel
 
PdfFormField  parent
  Parent form field. More...
 

Detailed Description

An AcroForm field containing textual data.

Constructor & Destructor Documentation

◆ PdfTextFormField() [1/3]

iText.Forms.Fields.PdfTextFormField.PdfTextFormField ( PdfDocument  pdfDocument )
inlinepackage

Creates a minimal PdfTextFormField.

Parameters
pdfDocument The iText.Kernel.Pdf.PdfDocument instance.

◆ PdfTextFormField() [2/3]

iText.Forms.Fields.PdfTextFormField.PdfTextFormField ( PdfWidgetAnnotation  widget,
PdfDocument  pdfDocument 
)
inlinepackage

Creates a text form field as a parent of a iText.Kernel.Pdf.Annot.PdfWidgetAnnotation.

Parameters
widget The widget which will be a kid of the PdfTextFormField.
pdfDocument The iText.Kernel.Pdf.PdfDocument instance.

◆ PdfTextFormField() [3/3]

iText.Forms.Fields.PdfTextFormField.PdfTextFormField ( PdfDictionary  pdfObject )
inlinepackage

Creates a text form field as a wrapper object around a iText.Kernel.Pdf.PdfDictionary.

Creates a text form field as a wrapper object around a iText.Kernel.Pdf.PdfDictionary. This iText.Kernel.Pdf.PdfDictionary must be an indirect object.

Parameters
pdfObject the dictionary to be wrapped, must have an indirect reference.

Member Function Documentation

◆ GetFormType()

override PdfName iText.Forms.Fields.PdfTextFormField.GetFormType ( )
inlinevirtual

Returns Tx, the form type for textual form fields.

Returns
the form type, as a iText.Kernel.Pdf.PdfName

Reimplemented from iText.Forms.Fields.PdfFormField.

◆ GetMaxLen()

virtual int iText.Forms.Fields.PdfTextFormField.GetMaxLen ( )
inlinevirtual

Gets the maximum length of the field's text, in characters.

Gets the maximum length of the field's text, in characters. This is an optional parameter, so if it is not specified, 0 value will be returned.

Returns
the current maximum text length

◆ IsComb()

virtual bool iText.Forms.Fields.PdfTextFormField.IsComb ( )
inlinevirtual

Meaningful only if the MaxLen entry is present in the text field dictionary and if the Multiline, Password, and FileSelect flags are clear.

Meaningful only if the MaxLen entry is present in the text field dictionary and if the Multiline, Password, and FileSelect flags are clear. If true, the field is automatically divided into as many equally spaced positions, or combs, as the value of MaxLen, and the text is laid out into those combs.

Returns
whether or not combing is enabled

◆ IsFileSelect()

virtual bool iText.Forms.Fields.PdfTextFormField.IsFileSelect ( )
inlinevirtual

If true, the text entered in the field represents the pathname of a file whose contents are to be submitted as the value of the field.

Returns
whether or not this field currently represents a path

◆ IsRichText()

virtual bool iText.Forms.Fields.PdfTextFormField.IsRichText ( )
inlinevirtual

If true, the value of this field should be represented as a rich text string.

If true, the value of this field should be represented as a rich text string. If the field has a value, the RV entry of the field dictionary specifies the rich text string.

Returns
whether or not text is currently represented as rich text

◆ IsScroll()

virtual bool iText.Forms.Fields.PdfTextFormField.IsScroll ( )
inlinevirtual

If true, the field scrolls (horizontally for single-line fields, vertically for multiple-line fields) to accommodate more text than fits within its annotation rectangle.

If true, the field scrolls (horizontally for single-line fields, vertically for multiple-line fields) to accommodate more text than fits within its annotation rectangle. Once the field is full, no further text is accepted.

Returns
whether or not longer texts are currently allowed

◆ IsSpellCheck()

virtual bool iText.Forms.Fields.PdfTextFormField.IsSpellCheck ( )
inlinevirtual

If true, text entered in the field is spell-checked.

Returns
whether or not spell-checking is currently enabled

◆ SetComb()

virtual iText.Forms.Fields.PdfTextFormField iText.Forms.Fields.PdfTextFormField.SetComb ( bool  comb )
inlinevirtual

Meaningful only if the MaxLen entry is present in the text field dictionary and if the Multiline, Password, and FileSelect flags are clear.

Meaningful only if the MaxLen entry is present in the text field dictionary and if the Multiline, Password, and FileSelect flags are clear. If true, the field is automatically divided into as many equally spaced positions, or combs, as the value of MaxLen, and the text is laid out into those combs.

Parameters
comb whether or not to enable combing
Returns
current PdfTextFormField

◆ SetFileSelect()

virtual iText.Forms.Fields.PdfTextFormField iText.Forms.Fields.PdfTextFormField.SetFileSelect ( bool  fileSelect )
inlinevirtual

If true, the text entered in the field represents the pathname of a file whose contents are to be submitted as the value of the field.

Parameters
fileSelect whether or not this field should represent a path
Returns
current PdfTextFormField

◆ SetMaxLen()

virtual iText.Forms.Fields.PdfTextFormField iText.Forms.Fields.PdfTextFormField.SetMaxLen ( int  maxLen )
inlinevirtual

Sets the maximum length of the field's text, in characters.

Parameters
maxLen the maximum text length
Returns
current

◆ SetMultiline()

virtual iText.Forms.Fields.PdfTextFormField iText.Forms.Fields.PdfTextFormField.SetMultiline ( bool  multiline )
inlinevirtual

If true, the field can contain multiple lines of text; if false, the field?s text is restricted to a single line.

Parameters
multiline whether or not the file can contain multiple lines of text
Returns
current PdfTextFormField

◆ SetPassword()

virtual iText.Forms.Fields.PdfTextFormField iText.Forms.Fields.PdfTextFormField.SetPassword ( bool  password )
inlinevirtual

If true, the field is intended for entering a secure password that should not be echoed visibly to the screen.

If true, the field is intended for entering a secure password that should not be echoed visibly to the screen. Characters typed from the keyboard should instead be echoed in some unreadable form, such as asterisks or bullet characters.

Parameters
password whether or not to obscure the typed characters
Returns
current PdfTextFormField

◆ SetRichText()

virtual iText.Forms.Fields.PdfTextFormField iText.Forms.Fields.PdfTextFormField.SetRichText ( bool  richText )
inlinevirtual

If true, the value of this field should be represented as a rich text string.

If true, the value of this field should be represented as a rich text string. If the field has a value, the RV entry of the field dictionary specifies the rich text string.

Parameters
richText whether or not to represent text as rich text
Returns
current PdfTextFormField

◆ SetScroll()

virtual iText.Forms.Fields.PdfTextFormField iText.Forms.Fields.PdfTextFormField.SetScroll ( bool  scroll )
inlinevirtual

If true, the field scrolls (horizontally for single-line fields, vertically for multiple-line fields) to accommodate more text than fits within its annotation rectangle.

If true, the field scrolls (horizontally for single-line fields, vertically for multiple-line fields) to accommodate more text than fits within its annotation rectangle. Once the field is full, no further text is accepted.

Parameters
scroll whether or not to allow longer texts
Returns
current PdfTextFormField

◆ SetSpellCheck()

virtual iText.Forms.Fields.PdfTextFormField iText.Forms.Fields.PdfTextFormField.SetSpellCheck ( bool  spellCheck )
inlinevirtual

If true, text entered in the field is spell-checked.

Parameters
spellCheck whether or not to spell-check
Returns
current PdfTextFormField

Member Data Documentation

◆ FF_COMB

readonly int iText.Forms.Fields.PdfTextFormField.FF_COMB = MakeFieldFlag(25)
static

constant which determines maximum length of the field's text.

◆ FF_DO_NOT_SCROLL

readonly int iText.Forms.Fields.PdfTextFormField.FF_DO_NOT_SCROLL = MakeFieldFlag(24)
static

constant which determines whether longer texts are currently allowed.

◆ FF_DO_NOT_SPELL_CHECK

readonly int iText.Forms.Fields.PdfTextFormField.FF_DO_NOT_SPELL_CHECK = MakeFieldFlag(23)
static

constant which determines whether spell-checking is currently enabled

◆ FF_FILE_SELECT

readonly int iText.Forms.Fields.PdfTextFormField.FF_FILE_SELECT = MakeFieldFlag(21)
static

constant which determines whether field currently represents a path.

◆ FF_RICH_TEXT

readonly int iText.Forms.Fields.PdfTextFormField.FF_RICH_TEXT = MakeFieldFlag(26)
static

constant which determines whether text is currently represented as rich text.