New to Telerik Document Processing? Start a free 30-day trial
RadioButtonField Class
Updated on Jun 3, 2026
The RadioButtonField class corresponds to the FormFieldType.RadioButton enum value and represents a group of radio button options. You can select at most one option from the group.
Properties
RadioButtonField provides the following properties:
| Property | Description |
|---|---|
Value | Gets or sets the single choice that is selected. RadioOption has a single Value text property. |
DefaultValue | Gets or sets the default selected option used when the AcroForm is reset to its default values. |
Widgets | The collection of RadioButtonWidget annotations representing the field. Each widget represents a single radio button option through its Option property. Widgets are created with AddWidget() and removed with Remove(). Implements IEnumerable. |
Options | A RadioOptionCollection containing all available options for this field. Modify through the indexer, Add(), RemoveAt(), and Clear(). Each RadioOption instance can be added only once. |
AllowToggleOff | Indicates whether radio buttons can be deselected by clicking an already-selected radio button. |
ShouldUpdateRadiosInUnison | Indicates whether all radio buttons sharing the same RadioOption value are selected in unison. When false, at most one radio button is selected even if multiple share the same option value. |
Example 1: Create RadioButtonFields and add them to a page
C#
RadioButtonField radioButtonField = new RadioButtonField("SampleRadioButton");
radioButtonField.Widgets.AddWidget(new RadioOption("True")).Rect = new Rect(0, 0, 20, 20);
radioButtonField.Widgets.AddWidget(new RadioOption("False")).Rect = new Rect(25, 0, 20, 20);
radioButtonField.Widgets.AddWidget(new RadioOption("False")).Rect = new Rect(50, 0, 20, 20);
document.AcroForm.FormFields.Add(radioButtonField);
foreach (RadioButtonWidget widget in radioButtonField.Widgets)
{
document.Pages[0].Annotations.Add(widget);
widget.RecalculateContent();
}