Skip to content

# PDFRadioButtonField

Namespace: O2S.Components.PDF4NET.Forms

Defines an interactive Acrobat radiobutton field.

    public class PDFRadioButtonField : PDFField

Inheritance Object → PDFField → PDFRadioButtonField

## Constructors

### PDFRadioButtonField(String)

Initializes a new PDFRadioButtonField object.

    public PDFRadioButtonField(string name)

Parameters

`name` String
The field name.

## Properties

### AlternateName

Gets or sets the field alternate name.

    public string AlternateName { get; set; }

Property Value

String
An alternate field name that shall be used in place of the actual field name wherever the field shall be identified in the user interface.

### CalculateAction

Gets or sets the calculate action.

    public PDFJavaScriptAction CalculateAction { get; set; }

Property Value

PDFJavaScriptAction
A PDFJavaScriptAction that shall be performed to recalculate the value of this field when that of another field changes.

### Checked

Gets or set a value indicating whether the radio button is in the checked state.

    public bool Checked { get; set; }

Property Value

Boolean
True if the radio button is in the checked state; otherwise, false.

### CosDictionary

Gets the underlying COS object.

    public PDFCosDictionary CosDictionary { get; }

Property Value

PDFCosDictionary
A PDFCosDictionary object that backs this field object.

### DefaultValue

Gets or sets the field default value.

    public object DefaultValue { get; set; }

Property Value

Object
The field's default value.

### Export

Gets or sets a value indicating whether the field can be exported or not.

    public bool Export { get; set; }

Property Value

Boolean
If true, the field shall be exported by a submit-form action.

### Form

Gets the Acrobat form this field belongs to.

    public PDFForm Form { get; internal set; }

Property Value

PDFForm
The parent form of the field.

### FormatAction

Gets or sets the format action.

    public PDFJavaScriptAction FormatAction { get; set; }

Property Value

PDFJavaScriptAction
A PDFJavaScriptAction that shall be performed before the field is formatted to display its value.

### KeyPressAction

Gets or sets the keypress action.

    public PDFJavaScriptAction KeyPressAction { get; set; }

Property Value

PDFJavaScriptAction
A PDFJavaScriptAction that shall be performed when the user modifies a character in a text field or combo box or modifies the selection in a scrollable list box.

### MappingName

Gets or sets the field mapping name.

    public string MappingName { get; set; }

Property Value

String
The mapping name that shall be used when exporting interactive form field data from the document.

### Name

Gets or sets the field name.

    public string Name { get; set; }

Property Value

String
The name of the field.

Exceptions

ArgumentException
Thrown when the name is not valid (null, empty, unsupported characters).

### NoToggleToOff

Gets or sets a value indicating whether a radio button shall be selected at all times.

    public bool NoToggleToOff { get; set; }

Property Value

Boolean
If true, exactly one radio button shall be selected at all times.

Remarks

If set, exactly one radio button shall be selected at all times; selecting the currently selected button has no effect. If clear, clicking the selected button deselects it, leaving no button selected.

### RadiosInUnison

Gets or sets a value indicating whether all the widgets the same export value in the same radio button group should be selected.

    public bool RadiosInUnison { get; set; }

Property Value

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

Remarks

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

### ReadOnly

Gets or sets a value indicating whether the field is read-only.

    public bool ReadOnly { get; set; }

Property Value

Boolean
If true, the user may not change the value of the field. Any associated widget annotations will not interact with the user; that is, they will not respond to mouse clicks or change their appearance in response to mouse motions.

### Required

Gets or sets a value indicating whether the field is required.

    public bool Required { get; set; }

Property Value

Boolean
If true, the field shall have a value at the time it is exported by a submit-form action

### SelectedIndex

Gets or sets the lowest ordinal index of the selected widgets in the field.

    public int SelectedIndex { get; set; }

Property Value

Int32
The lowest ordinal index of the selected widgets in the field. The default is -1, which indicates that nothing is selected.

### TextDirection

Gets or sets the text direction.

    public PDFTextDirection TextDirection { get; set; }

Property Value

PDFTextDirection
A PDFTextDirection enum member specifying the direction of the text displayed in the field.

### Type

Gets the field type.

    public PDFFieldType Type { get; internal set; }

Property Value

PDFFieldType
The field type.

### ValidateAction

Gets or sets the validate action.

    public PDFJavaScriptAction ValidateAction { get; set; }

Property Value

PDFJavaScriptAction
A PDFJavaScriptAction that shall be performed when the field's value is changed. This action may check the new value for validity.

### Value

Gets or sets the field value.

    public object Value { get; set; }

Property Value

Object
The field value.

### Widgets

Gets the list of field widgets.

    public PDFFieldWidgetCollection Widgets { get; }

Property Value

PDFFieldWidgetCollection
The list of widgets that represent the field on PDF pages.