New to Telerik Document Processing? Start a free 30-day trial
ComboBoxField Class
Updated on May 11, 2026
This article describes the following topics:
Overview
This class corresponds to the FormFieldType.ComboBox enum value and represents a drop down control with choices that can be selected.
Properties
ComboBoxField provides the following properties:
| Property | Description |
|---|---|
Value | Gets or sets the single choice that is selected. ChoiceOption has Value and UserInterfaceValue properties. UserInterfaceValue is optional; when null, Value is used to display the choice in the UI. |
DefaultValue | Gets or sets the default selected choice used when the AcroForm is reset to its default values. |
Widgets | The collection of Widget annotations representing the field on the PDF pages. Widgets are created using AddWidget() and can be removed using Remove(). Implements IEnumerable. |
Options | A ChoiceOptionCollection containing all available choices for this field. Modify via the indexer, Add(), RemoveAt(), and Clear(). Each ChoiceOption instance can be added only once. |
ShouldCommitOnSelectionChange | Indicates whether to commit the selected value on selection change. |
HasEditableTextBox | Indicates whether the drop-down provides an additional text box input, allowing the user to enter a value different from the provided choices. |
ShouldSpellCheck | Indicates whether the text should be spell checked during input. |
Example 1: Create a ComboBoxField and add it to a page
C#
ComboBoxField comboBoxField = new ComboBoxField("SampleComboBox");
comboBoxField.Options.Add(new ChoiceOption("First Value"));
comboBoxField.Options.Add(new ChoiceOption("Second Value"));
comboBoxField.Options.Add(new ChoiceOption("Third Value"));
comboBoxField.Value = comboBoxField.Options[1];
VariableContentWidget widget = comboBoxField.Widgets.AddWidget();
widget.Rect = new Rect(100, 100, 200, 30);
widget.RecalculateContent();
document.AcroForm.FormFields.Add(comboBoxField);
document.Pages[0].Annotations.Add(widget);