New to Telerik Document Processing? Start a free 30-day trial
RadioButtonField class
Updated on May 11, 2026
This article describes the following topics:
Overview
The RadioButtonField class corresponds to FormFieldType.RadioButton enum value and represents a group of radio button options. The user 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 via its Option property. Widgets are created using AddWidget() and removed using Remove(). Implements IEnumerable. |
Options | A RadioOptionCollection containing all available options for this field. Modify via the indexer, Add(), RemoveAt(), and Clear(). Each RadioOption instance can be added only once. |
AllowToggleOff | Indicates whether radio buttons can be deselected by clicking on an already-selected radio button. |
ShouldUpdateRadiosInUnison | Indicates whether all radio buttons sharing the same RadioOption value should be selected in unison. When false, at most one radio button will be 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();
}