Content Controls

Content controls are individual controls that you can add and customize for use in templates, forms, and documents. These controls are commonly used in MS Word templates and forms and replace the old form fields. Both types of form fields are supported by TX Text Control and will be automatically imported and converted to TX Text Control form fields.

Important

Only the Office Open XML (DOCX) format, not the MS Word 97-2003 document format, supports content controls in MS Word documents.

If you are using fields from other applications, such as MS Word, there are a number of ways to handle these fields. When loading a document, the &#9584; TX Text Control .NET Server &#9584; TXTextControl Namespace &#9584; LoadSettings Class &#9584; ApplicationFieldFormat Property Specifies the format of text fields which are imported. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Application Field Format property can be used to specify how a field is imported. There are three relevant options that can be specified when importing fields:

None Text fields supported by other applications are not imported as ApplicationFields. Form fields are imported as TX Text Control FormFields. MSWord Fields that are supported and defined by Microsoft Word are imported as ApplicationFields. The &#9584; TX Text Control .NET Server &#9584; TXTextControl Namespace &#9584; LoadSettings Class &#9584; ApplicationFieldTypeNames Property Specifies an array of strings containing the type names of fields which are to be imported. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Application Field Type Names property can be used to select specific types of fields. MSWordTXFormFields Fields that are supported and defined by Microsoft Word are imported as &#9584; TX Text Control .NET Server &#9584; TXTextControl Namespace &#9584; ApplicationField Class The ApplicationField class supports text field formats of applications such as Microsoft Word. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Application Fields , with the exception of form fields. Form fields such as combo boxes, check boxes, and form text fields are imported as TX Text Control &#9584; TX Text Control .NET Server &#9584; TXTextControl Namespace &#9584; FormField Class The FormField class is the base class of all form fields. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Form Fields .

Field Overview

The table below shows how fields are imported based on the specified LoadSettings :

Field Document Format Imported as ( &#9584; TX Text Control .NET for Windows Forms &#9584; TXTextControl Namespace &#9584; LoadSettings Class &#9584; ApplicationFieldFormat Property Specifies the format of text fields which are imported. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Load Settings ) None MSWord MSWordTXFormFields TextField InternalUnicodeFormat, InternalFormat &#9584; TX Text Control .NET for Windows Forms &#9584; TXTextControl Namespace &#9584; TextField Class An instance of the TextField class represents a text field in a Text Control document. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Text Field N/A N/A MergeField MSWord, WordprocessingML, RichTextFormat × &#9584; TX Text Control .NET for Windows Forms &#9584; TXTextControl Namespace &#9584; ApplicationField Class The ApplicationField class supports text field formats of applications such as Microsoft Word. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Application Field &#9584; TX Text Control .NET for Windows Forms &#9584; TXTextControl Namespace &#9584; ApplicationField Class The ApplicationField class supports text field formats of applications such as Microsoft Word. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Application Field DOCVARIABLE MSWord, WordprocessingML, RichTextFormat × &#9584; TX Text Control .NET for Windows Forms &#9584; TXTextControl Namespace &#9584; ApplicationField Class The ApplicationField class supports text field formats of applications such as Microsoft Word. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Application Field &#9584; TX Text Control .NET for Windows Forms &#9584; TXTextControl Namespace &#9584; ApplicationField Class The ApplicationField class supports text field formats of applications such as Microsoft Word. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Application Field Content Control MSWord, WordprocessingML, RichTextFormat &#9584; TX Text Control .NET for Windows Forms &#9584; TXTextControl Namespace &#9584; FormField Class The FormField class is the base class of all form fields. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Form Fields &#9584; TX Text Control .NET for Windows Forms &#9584; TXTextControl Namespace &#9584; ApplicationField Class The ApplicationField class supports text field formats of applications such as Microsoft Word. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Application Field &#9584; TX Text Control .NET for Windows Forms &#9584; TXTextControl Namespace &#9584; FormField Class The FormField class is the base class of all form fields. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Form Fields Legacy Form Fields MSWord, WordprocessingML, RichTextFormat &#9584; TX Text Control .NET for Windows Forms &#9584; TXTextControl Namespace &#9584; FormField Class The FormField class is the base class of all form fields. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Form Fields &#9584; TX Text Control .NET for Windows Forms &#9584; TXTextControl Namespace &#9584; ApplicationField Class The ApplicationField class supports text field formats of applications such as Microsoft Word. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Application Field &#9584; TX Text Control .NET for Windows Forms &#9584; TXTextControl Namespace &#9584; FormField Class The FormField class is the base class of all form fields. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Form Fields

Importing Content Controls

Consider the following MS Word document to which several Content Controls have been added.

The following code shows how to load the document with Content Control fields automatically converted to TX Text Control fields.

TXTextControl.LoadSettings loadSettings = new TXTextControl.LoadSettings() { ApplicationFieldFormat = TXTextControl.ApplicationFieldFormat.MSWordTXFormFields };

using (TXTextControl.ServerTextControl serverTextControl = new TXTextControl.ServerTextControl()) { serverTextControl.Create(); serverTextControl.Load("contentcontrols.docx", TXTextControl.StreamType.WordprocessingML, loadSettings);

foreach (FormField ff in serverTextControl.FormFields) { Console.WriteLine(ff.Text); } } When the document is loaded into a visual TX Text Control, the Content Control fields are rendered as form fields by default.

Processing Content Controls

Another way to access Content Controls is to import the document without converting them to form fields. In this case, Content Controls are accessible through the &#9584; TX Text Control .NET Server &#9584; TXTextControl Namespace &#9584; ServerTextControl Class &#9584; ApplicationFields Property Gets a collection of all Microsoft Word or Heiler HighEdit fields that have been created or imported from a Microsoft Word or RTF document. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Application Fields collection to provide more access to the contained data.

The DocumentServer includes the &#9584; TX Text Control .NET Server &#9584; DocumentServer.Fields Namespace TXTextControl.DocumentServer.Fields Namespace " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Fields namespace, which contains field classes for retrieving additional data from Content Controls such as &#9584; TX Text Control .NET Server &#9584; DocumentServer.Fields Namespace &#9584; ContentControlFieldAdapter Class &#9584; Title Property Gets or sets the content control&#039;s title. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Title or &#9584; TX Text Control .NET Server &#9584; DocumentServer.Fields Namespace &#9584; ContentControlFieldAdapter Class &#9584; Tag Property Gets or sets the content control&#039;s tag. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Tag .

The following code shows how to access the Content Controls in the document.

LoadSettings ls = new LoadSettings() { ApplicationFieldFormat = ApplicationFieldFormat.MSWord };

using (ServerTextControl tx = new ServerTextControl()) { tx.Create(); tx.Load("contentcontrols.docx", StreamType.WordprocessingML, ls);

foreach (ApplicationField af in tx.ApplicationFields) { try { var tempField = ContentControlFieldAdapter.CreateContentControl(af);

if (tempField is RichTextContentControl || tempField is PlainTextContentControl || tempField is CheckBoxContentControl || tempField is ComboBoxContentControl || tempField is DateContentControl || tempField is DropDownListContentControl) { Console.WriteLine(tempField.Title); } } catch (Exception ex) { Console.WriteLine(ex.Message); } } } Conclusion

Content controls are used to create structured documents and forms. This article showed how to import and process content controls in MS Word documents using TX Text Control. TX Text Control supports legacy form fields, merge fields, and Content Control fields, making them easy to import and edit.

TX Text Control .NET Server

DS Server

Server & Web

Windows Forms

WPF

ActiveX

Core Technologies

Blog

Core Technologies

Blog

Authors

Latest Posts

Support Resources

Documentation

Support

Getting Started

Other Resources

About Us

Industry events

Company

Contact

Newsletter

Legal

Sign in

Create account

Text Control Account

Content Controls

Post tagged with Content Controls in 2024

Server & Web

Windows Forms

WPF

ActiveX

Core Technologies

​

Latest Posts

​

Support

Getting Started

​

Other Resources

Company

Contact

Newsletter

Legal

Text Control Account

​

​

Content Controls

Post tagged with Content Controls in 2024 ​

March 2024

Post tagged with Content Controls in 2024