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

An interactive control on the screen that raises events and/or can retain data. More...

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

Public Member Functions

override PdfName  GetFormType ()
  Returns Btn, the form type for choice form fields. More...
 
virtual bool  IsRadio ()
  If true, the field is a set of radio buttons; if false, the field is a check box. More...
 
virtual iText.Forms.Fields.PdfButtonFormField  SetRadio (bool radio)
  If true, the field is a set of radio buttons; if false, the field is a check box. More...
 
virtual bool  IsToggleOff ()
  If true, clicking the selected button deselects it, leaving no button selected. More...
 
virtual iText.Forms.Fields.PdfButtonFormField  SetToggleOff (bool toggleOff)
  If true, clicking the selected button deselects it, leaving no button selected. More...
 
virtual bool  IsPushButton ()
  If true, the field is a pushbutton that does not retain a permanent value. More...
 
virtual iText.Forms.Fields.PdfButtonFormField  SetPushButton (bool pushButton)
  If true, the field is a pushbutton that does not retain a permanent value. More...
 
virtual bool  IsRadiosInUnison ()
  If true, a group of radio buttons within a radio button field that use the same value for the on state will turn on and off in unison; that is if one is checked, they are all checked. More...
 
virtual iText.Forms.Fields.PdfButtonFormField  SetRadiosInUnison (bool radiosInUnison)
  If true, a group of radio buttons within a radio button field that use the same value for the on state will turn on and off in unison; that is if one is checked, they are all checked. More...
 
virtual iText.Forms.Fields.PdfButtonFormField  SetImage (String image)
  Set image to be used as a background content in a push button. More...
 
virtual iText.Forms.Fields.PdfButtonFormField  SetImageAsForm (PdfFormXObject form)
  Set image to be used as a background content in a push button as iText.Kernel.Pdf.Xobject.PdfFormXObject. More...
 
override PdfFormField  AddKid (AbstractPdfFormField kid)
  Adds a new kid to the Kids array property from a AbstractPdfFormField. 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, 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_NO_TOGGLE_TO_OFF = MakeFieldFlag(15)
  If true, clicking the selected button deselects it, leaving no button selected. More...
 
static readonly int  FF_RADIO = MakeFieldFlag(16)
  If true, the field is a set of radio buttons. More...
 
static readonly int  FF_PUSH_BUTTON = MakeFieldFlag(17)
  If true, the field is a push button that does not retain a permanent value. More...
 
static readonly int  FF_RADIOS_IN_UNISON = MakeFieldFlag(26)
  If true, a group of radio buttons within a radio button field, that use the same value for the on state will turn on and off in unison. 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

  PdfButtonFormField (PdfDocument pdfDocument)
  Creates a minimal PdfButtonFormField. More...
 
  PdfButtonFormField (PdfWidgetAnnotation widget, PdfDocument pdfDocument)
  Creates a button form field as a parent of a iText.Kernel.Pdf.Annot.PdfWidgetAnnotation. More...
 
  PdfButtonFormField (PdfDictionary pdfObject)
  Creates a button 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 interactive control on the screen that raises events and/or can retain data.

Constructor & Destructor Documentation

◆ PdfButtonFormField() [1/3]

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

Creates a minimal PdfButtonFormField.

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

◆ PdfButtonFormField() [2/3]

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

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

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

◆ PdfButtonFormField() [3/3]

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

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

Creates a button 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

◆ AddKid()

override PdfFormField iText.Forms.Fields.PdfButtonFormField.AddKid ( AbstractPdfFormField  kid )
inlinevirtual

Adds a new kid to the Kids array property from a AbstractPdfFormField.

Parameters
kid

Adds a new kid to the Kids array property from a AbstractPdfFormField.

Returns

Adds a new kid to the Kids array property from a AbstractPdfFormField.

Reimplemented from iText.Forms.Fields.PdfFormField.

◆ GetFormType()

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

Returns Btn, the form type for choice form fields.

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

Reimplemented from iText.Forms.Fields.PdfFormField.

◆ IsPushButton()

virtual bool iText.Forms.Fields.PdfButtonFormField.IsPushButton ( )
inlinevirtual

If true, the field is a pushbutton that does not retain a permanent value.

Returns
whether or not the field is currently a pushbutton

◆ IsRadio()

virtual bool iText.Forms.Fields.PdfButtonFormField.IsRadio ( )
inlinevirtual

If true, the field is a set of radio buttons; if false, the field is a check box.

If true, the field is a set of radio buttons; if false, the field is a check box. This flag only works if the Pushbutton flag is set to false.

Returns
whether the field is currently radio buttons or a checkbox

◆ IsRadiosInUnison()

virtual bool iText.Forms.Fields.PdfButtonFormField.IsRadiosInUnison ( )
inlinevirtual

If true, a group of radio buttons within a radio button field that use the same value for the on state will turn on and off in unison; that is if one is checked, they are all checked.

If true, a group of radio buttons within a radio button field that use the same value for the on state will turn on and off in unison; that is if one is checked, they are all checked. If false, the buttons are mutually exclusive

Returns
whether or not buttons are turned off in unison

◆ IsToggleOff()

virtual bool iText.Forms.Fields.PdfButtonFormField.IsToggleOff ( )
inlinevirtual

If true, clicking the selected button deselects it, leaving no button selected.

If true, clicking the selected button deselects it, leaving no button selected. If false, exactly one radio button shall be selected at all times. Only valid for radio buttons.

Returns
whether a radio button currently allows to choose no options

◆ SetImage()

virtual iText.Forms.Fields.PdfButtonFormField iText.Forms.Fields.PdfButtonFormField.SetImage ( String  image )
inlinevirtual

Set image to be used as a background content in a push button.

Parameters
image path to the image to be used.
Returns
this PdfButtonFormField

◆ SetImageAsForm()

virtual iText.Forms.Fields.PdfButtonFormField iText.Forms.Fields.PdfButtonFormField.SetImageAsForm ( PdfFormXObject  form )
inlinevirtual

Set image to be used as a background content in a push button as iText.Kernel.Pdf.Xobject.PdfFormXObject.

Parameters
form

iText.Kernel.Pdf.Xobject.PdfFormXObject to be used as an image

Returns
this PdfButtonFormField

◆ SetPushButton()

virtual iText.Forms.Fields.PdfButtonFormField iText.Forms.Fields.PdfButtonFormField.SetPushButton ( bool  pushButton )
inlinevirtual

If true, the field is a pushbutton that does not retain a permanent value.

Parameters
pushButton whether or not to set the field to a pushbutton
Returns
current PdfButtonFormField

◆ SetRadio()

virtual iText.Forms.Fields.PdfButtonFormField iText.Forms.Fields.PdfButtonFormField.SetRadio ( bool  radio )
inlinevirtual

If true, the field is a set of radio buttons; if false, the field is a check box.

If true, the field is a set of radio buttons; if false, the field is a check box. This flag should be set only if the Pushbutton flag is set to false.

Parameters
radio whether the field should be radio buttons or a checkbox
Returns
current PdfButtonFormField

◆ SetRadiosInUnison()

virtual iText.Forms.Fields.PdfButtonFormField iText.Forms.Fields.PdfButtonFormField.SetRadiosInUnison ( bool  radiosInUnison )
inlinevirtual

If true, a group of radio buttons within a radio button field that use the same value for the on state will turn on and off in unison; that is if one is checked, they are all checked.

If true, a group of radio buttons within a radio button field that use the same value for the on state will turn on and off in unison; that is if one is checked, they are all checked. If false, the buttons are mutually exclusive

Parameters
radiosInUnison whether or not buttons should turn off in unison
Returns
current PdfButtonFormField

◆ SetToggleOff()

virtual iText.Forms.Fields.PdfButtonFormField iText.Forms.Fields.PdfButtonFormField.SetToggleOff ( bool  toggleOff )
inlinevirtual

If true, clicking the selected button deselects it, leaving no button selected.

If true, clicking the selected button deselects it, leaving no button selected. If false, exactly one radio button shall be selected at all times.

Parameters
toggleOff whether a radio button may allow to choose no options
Returns
current PdfButtonFormField

Member Data Documentation

◆ FF_NO_TOGGLE_TO_OFF

readonly int iText.Forms.Fields.PdfButtonFormField.FF_NO_TOGGLE_TO_OFF = MakeFieldFlag(15)
static

If true, clicking the selected button deselects it, leaving no button selected.

If true, clicking the selected button deselects it, leaving no button selected. If false, exactly one radio button shall be selected at all times.

◆ FF_PUSH_BUTTON

readonly int iText.Forms.Fields.PdfButtonFormField.FF_PUSH_BUTTON = MakeFieldFlag(17)
static

If true, the field is a push button that does not retain a permanent value.

◆ FF_RADIO

readonly int iText.Forms.Fields.PdfButtonFormField.FF_RADIO = MakeFieldFlag(16)
static

If true, the field is a set of radio buttons.

If true, the field is a set of radio buttons. If false, the field is a check box. This flag should be set only if the FF_PUSH_BUTTON flag is set to false.

◆ FF_RADIOS_IN_UNISON

readonly int iText.Forms.Fields.PdfButtonFormField.FF_RADIOS_IN_UNISON = MakeFieldFlag(26)
static

If true, a group of radio buttons within a radio button field, that use the same value for the on state will turn on and off in unison.

If true, a group of radio buttons within a radio button field, that use the same value for the on state will turn on and off in unison. That is if one is checked, they are all checked. If false, the buttons are mutually exclusive.