Available for: UI for ASP.NET MVC | UI for ASP.NET AJAX | UI for Blazor | UI for WPF | UI for WinForms | UI for Silverlight | UI for Xamarin | UI for WinUI | UI for ASP.NET Core | UI for .NET MAUI

New to Telerik Document Processing? Download free 30-day trial

TextBoxField Class

This article describes the following topics:

Overview

This class corresponds to FormFieldType.TextBox enum value and represents a TextBox data container.

Properties

TextBoxField exposes the following properties:

  • Value: Gets or sets the current text value of the field.

  • DefaultValue: Gets or sets the default value used when the AcroForm is reset to its default values.

  • Widgets: The collection of Widget annotations, which represent the field on the PDF pages. The widgets can be added and removed from the collection using the collection's AddWidget() and Remove() methods respectively. As the widget collection implements the IEnumerable interface, the available widget instances can be iterated.

  • IsMultiline: Boolean value indicating whether the text box should support multiline text input.

  • IsPassword: Boolean value indicating whether the text input is password. Setting this property to true will force the viewer to display the password input by hiding the inputted characters.

  • IsFileSelect: Boolean value indicating whether the field represents path name of a file whose contents are to be submitted as the value of the field.

  • ShouldSpellCheck: Boolean value indicating whether the text should be spell checked during its input.

  • AllowScroll: Boolean value indicating whether to allow scrolling for bigger text content. If the scrolling is not allowed, then the maximum text input is restricted to the Widget annotation rectangle.

  • MaxLengthOfInputCharacters: Nullable integer value specifying the maximal length of the inputted text. When null, the text is not restricted to any specified length.

Example 1: Create a TextBoxField and add it to a page

TextBoxField textField = new TextBoxField("SampleTextBox") 
{ 
    MaxLengthOfInputCharacters = 500, 
    IsMultiline = true, 
    IsPassword = false, 
    IsFileSelect = false, 
    ShouldSpellCheck = true, 
    AllowScroll = true, 
    Value = "Sample content", 
}; 
 
VariableContentWidget widget = textField.Widgets.AddWidget(); 
widget.Rect = new Rect(new Size(250, 50)); 
widget.RecalculateContent(); 
 
document.AcroForm.FormFields.Add(textField); 
document.Pages[0].Annotations.Add(widget); 

See Also

In this article