TX Text Control X15 allows the insertion and manipulation of text fields of type TXTextControl.ApplicationField and TXTextControl.TextField . A TextField is a TX Text Control internal field and ApplicationFields are MS Word compatible MergeFields, FormFields or any other supported field type.

TXTextControl.MergeField objects can be added using the Reporting ribbon tab that allows the insertion of fields from a specified data source such as Json or an XML string. These fields can now be added programmatically using the TXTextControl JavaScript API.

The following JavaScript code creates and inserts a new merge field into the document at the current input position:


The textFieldEntered event that can be attached using the Javascript: TXTextControl.addEventListener method is fired when the input position enters a text field. The event arguments return the properties of the current field. In order to manipulate the field object directly, the Javascript: TXTextControl.getTextFields method can be used which returns all fields or the field at the current input position.

The following JavaScript code changes the field text when the input position enters the text field:


ApplicationFields are technically all field types that are supported by MS Word including merge fields, content controls and legacy form fields. The following JavaScript code inserts a legacy form drop down field into the TX Text Control:


In the document, form element fields are represented by their display text (as they would be printed or exported to PDF). All field objects provide a Javascript: TXTextControl.TextField.bounds property that provides the size and the location of a field. This information can be used to render the actual form element at that location. The following code renders an HTML drop down box at the field location:


The following screen cast shows the inserted drop down box in action. A custom button has been added to a new ribbon group to insert a drop down field.

Field overlays with TX Text Control

Try this on your own and download the sample hosted on GitHub.


Download and Fork This Sample on GitHub

We proudly host our sample code on github.com/TextControl.

Please fork and contribute.

Requirements for This Sample

  • Visual Studio 2015 or better
  • TX Text Control .NET Server for ASP.NET (trial sufficient)