New Features

TX Text Control 30.0 provides the following new features:

Extended Character Attributes

TextControl supports now automatic sub- and superscript settings, text effects with uppercase letters and a user-defined character spacing and scaling. The new properties Selection.AutoBaseline, Selection.Capitals, Selection.CharacterScaling and Selection.CharacterSpacing can be used to define or retrieve these settings. When using automatic sub- and superscript the font is scaled and moved above or below the baseline with values defined through the font itself. When a font does not define these values, TextControl uses a scaling of 50% and moving of 40% above and 15% below the baseline. In addition to standard sub- and superscript TextControl also offers subscripts aligned at the baseline and superscripts that do not extend above the ascender line. These special sub- and superscripts can be used for numerators and denominators of diagonal fractions such as the Spanish c/u (cada uno) or for ordinal indicators such as the English 1th. All of these automatic sub- and superscript features can be combined with a user-defined baseline position which can furthermore be set with the Selection.Baseline property. Further text effects are capital and small capital letters. In all cases lowercase letters are displayed either with capital letters of the same size or with capital letters which have a smaller size. The smaller size is either the size of the lowercase 'x' (petite caps) or the size of the lowercase 'x' + 10% (small caps). A further new character attribute is a user-defined character spacing where a fixed value is added to each character. When this value is negative, character spacing is reduced, otherwise it is extended. Character widths can also be scaled now specified in percent of the average character width. All new attributes are also available as attributes of formatting styles. The font and formatting style dialogboxes have been extended to make them available for the end-user. All text filters have been extended to exchange the new attributes with other applications.


Parts of a document can be commented now. An end-user can select a piece of text and open a comment input control through the context menu to type the comment's text. When the input control is closed, either through a mouse click or through the Enter key, the comment is added to the document and the commented text is highlighted on the screen with a color depending on the user, the default color for the current user is red. The comment's context menu also offers entries to change, remove and reply to a comment. All comments in a document are available in a CommentCollection which can be obtained through the new TextControl.Comments or WPF.TextControl.Comments properties. The collection consists of CommentedText objects which describe the commented piece of text and the comment itself. Programmatically, a comment can be added to the document with the collection's Add methods, which either open the comment input control or add a prepared CommentedText object. Each comment has a creation time and is related to a user. When a new comment is inserted, the current user is associated with it. The current user is the first in the list of users set with the TextControl.UserNames property. When the list of users is empty, the UserName is set to an empty string which is interpreted as an unknown user. Comments can have replies which are also contained as CommentedText objects in the CommentCollection. Replies are associated with the same piece of text, but can be related to another user and can have another creation time. The relationship is available through the CommentedText.Replies and CommentedText.RepliedComment properties. When the original comment is removed from the document all of its replies are also removed. Events occur, when a comment is created (CommentCreated), deleted (CommentDeleted) or the text of the comment is changed (CommentChanged). Further events occur, when the current input position has been moved to a position that belongs to a commented piece of text (CommentedTextEntered) or when the current input position has left it (CommentedTextLeft). Comments are saved and can be reloaded with the TextControl text format (.tx), the Rich Text Format (.rtf) and the Microsoft Word formats (.doc, .docx).

Comments Sidebar

In addition to this feature, the new comments sidebar content layout is provided to show, select and edit the comments of the document. It can be used either by connecting a sidebar with one of the two RibbonProofingTab properties CommentsSidebar and CommentsHorizontalSidebar, or by setting its ContentLayout property to the Comments enum and binding the sidebar with the corresponding TextControl.

Scalable Vector Graphics

Images saved with the SVG (Scalable Vector Graphics) format can be integrated in TextControl documents. All formatting options available with other images are also available with this image format. When a document is saved in PDF format, contained SVG images are converted to the PDF vector format. Based on the World Wide Web Consortium (W3C) SVG 1.1 (Second Edition) standard, all features are supported, except referencing to external images or style sheets, interactivity and animation, advanced text transformations and image processing features such as patterns, masking, compositing and filter effects.


The border of a textframe can be colored now and the border can be a single or a double line. The TextControl.TextFrameAttributesDialog and WPF.TextControl.TextFrameAttributesDialog dialog boxes and the Windows.Forms.Ribbon.RibbonFrameLayoutTab and WPF.RibbonFrameLayoutTab ribbon tabs have been extended accordingly. The new properties TextFrame.BorderColor and TextFrame.BorderStyle can be used to set or to get these attributes programmatically.

Formatting Styles

The input language used with spellchecking and hyphenation can now be specified as an attribute of character- and paragraph-based formatting styles. The formatting style dialogbox and all text filters have been extended to support this feature.

HTML5 Document Editor

The HTML5 Document Editor now supports automatic sub- and superscript settings, text effects with uppercase letters and a user-defined character spacing and scaling. To access these new features the classes Selection and FormattingStyle have been extended. The ruler bars and the status bar are now fully customizable via the newly introduced properties TXTextControl.rulerBar, TXTextControl.verticalRulerBar and TXTextControl.statusBar. Two new sidebars have been added to the HTML5 Document Editor: A "Field Navigator" and an overview over the comments in a document. To allow easier side bar access the Ribbon now has an additional, fully configurable and always visible toggle button with a drop down menu in the top right corner. Finally, the JavaScript API has been extended and supports the same inteface to the new document comments as the .NET version of the Text Control API does (see TXTextControl.comments).

Document Server

The MailMerge class is now able to merge data into form fields. For this purpose the new property MailMerge.FormFieldMergeType has been introduced which allows to control whether form fields are pre-selected during merge, completely replaced or not affected by the merge process at all.