New to Telerik Document ProcessingStart 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:

PropertyDescription
ValueGets or sets the single choice that is selected. RadioOption has a single Value text property.
DefaultValueGets or sets the default selected option used when the AcroForm is reset to its default values.
WidgetsThe 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.
OptionsA RadioOptionCollection containing all available options for this field. Modify via the indexer, Add(), RemoveAt(), and Clear(). Each RadioOption instance can be added only once.
AllowToggleOffIndicates whether radio buttons can be deselected by clicking on an already-selected radio button.
ShouldUpdateRadiosInUnisonIndicates 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();
}

See Also

In this article
OverviewPropertiesSee Also
Not finding the help you need?
Contact Support