What's New in Version 15.0 — TX Text Control .NET for WPF

Documents gained columns, PDF/A archiving and a PDF import in TX Text Control 15.0. The version also made paragraphs programmable as objects and introduced the field adapters of the DocumentServer.Fields namespace.

Version 15.0 was released in May 2009 for the server and the client products, as the press release Press Release: TX Text Control 15.0 is Released announced. Its PDF/A export produces PDF/A-1b documents. TX Text Control .NET for WPF didn't exist yet: its first version was Version 16.0, and the classes below belong to the class library that it shares with the Windows Forms edition. The ASP.NET DocumentViewer of the version belongs to the ASP.NET products and isn't listed here, nor are features of the Windows Forms control, such as the button for structured lists and the customizable clipboard.

Version 15.0 at a Glance

Area	What is new
Columns	Text arranged in columns, per section
PDF	PDF/A-1 Level B export, text import from PDF documents
Lists	Structured numbered lists, longer text before and after the number
Paragraphs	A collection of `Paragraph` objects for each text part
Page images	An image of the content of a page
Fields	The `DocumentServer.Fields` namespace with adapters for MS Word fields, the `DocumentController`
Mail merge	IF, DATE and INCLUDETEXT fields, events for merged fields and included documents

Columns

The text of a section can be arranged in columns, so that one page can have different numbers of columns where a section begins. SectionFormat.Columns sets the number of columns. When EqualColumnWidth is true, which is the default, all columns get the same width, calculated from the page size. Otherwise, ColumnWidths and ColumnDistances set each width and distance, and ColumnLineColor and ColumnLineWidth draw a line between the columns. A column break continues the text in the next column. See Sections, Pages, Headers, and Footers.

PDF/A and PDF Import

PDF/A. Documents can be saved as PDF/A-1 Level B, the ISO standard for archiving, with the StreamType and BinaryStreamType value AdobePDFA. Besides the content of a standard PDF document, a PDF/A document contains only embeddable fonts, stores document data such as the title and the author as XMP, describes which characters of a font are used and contains a color profile. Links that start other applications and access restrictions aren't allowed, so SaveSettings.DocumentAccessPermissions is ignored.
Fonts for PDF/A. Set FontSettings.EmbeddableFontsOnly of ServerTextControl.FontSettings to true before you save, so that the document contains only embeddable fonts. The AdaptFont event, switched on with FontSettings.AdaptFontEvent, controls which font replaces one that can't be used; its AdaptFontEventArgs give the font name, the adapted font name and the supported fonts. See PDF/A.
PDF import. The StreamType value AdobePDF loads the text of a PDF document with all load methods. Because PDF describes where characters are and not how the document is structured, the import filter either makes each line a paragraph, builds paragraphs from the text flow or creates a text frame for each block of text at its original position. LoadSettings.PDFImportSettings selects the mode with a PDFImportSettings value. See PDF Import and Its Limitations.

Lists, Paragraphs and Pages

Structured lists. The ListType value Structured shows the numbers of all higher levels in front of the number of a list item, together with the text before and after them. ListFormat.TextBeforeNumber and ListFormat.TextAfterNumber hold text longer than one character.
Paragraphs. ServerTextControl.Paragraphs returns a ParagraphCollection; headers and footers and text frames have their own. Each Paragraph has its Format, ListFormat and FormattingStyle, its first character and line, its length, its lines and its Text. ListNumber and ListNumberText give its number in a list, and Save saves it in a format. See Text, Paragraphs, and Stylesheets.
Page images. Page.GetImage returns the content of a page as an enhanced metafile or as a bitmap in screen resolution.

Field Adapters and Mail Merge

Field adapters. The new DocumentServer.Fields namespace provides adapters for the MS Word merge fields and form fields that MailMerge uses: MergeField, FormText, FormCheckBox, FormDropDown, IfField, DateField and IncludeText. They create and change these fields without editing ApplicationField.Parameters by hand. See Fields and Subtext Parts.
Document controller. DocumentServer.DocumentController loads, saves and processes a document. GetFieldAdapters returns the adapters of its fields, and MergeField sets the value of a form field.
New field types in mail merge. MailMerge processes the MS Word fields IF, DATE and INCLUDETEXT. See Conditional Content.
Events. FieldMerged occurs for each merged field, and IncludeTextMerging for each document that an INCLUDETEXT field includes.
Search path. SearchPath names the directory where subtemplates and images are searched.

Upgrade to Version 15.0

List text. ListFormat.TextBeforeNumber and ListFormat.TextAfterNumber replace ListFormat.CharBeforeNumber and ListFormat.CharAfterNumber, which remain for compatibility and shouldn't be used in new code. See Deprecated APIs.
Obsolete text field property. The member list of version 15.0 marks TextField.ShowActivated as obsolete.

New Classes, Properties, Methods and Events

The classes and members below are the ones that the What's New documentation of version 15.0 lists for TX Text Control .NET for WPF. Names are relative to the TXTextControl namespace, each name links to its current reference page, and "(obsolete)" marks a member that is obsolete today. The version's own list also names TextField as a new class, but TextFieldCollection handled TextField objects in version 13.0, so it isn't listed under New Classes.

New Classes

Members by Class

Class	Properties	Methods	Events
AdaptFontEventArgs	AdaptedFontName, FontName, SupportedFonts
DocumentServer.DocumentController	CharCodeChecked, CharCodeUnchecked, CheckBoxFont, DpiX, DpiY, Pages, TextComponent	Dispose, GetBlockFieldNames, GetBlockNames, GetFieldAdapters, GetFieldNames, Load, LoadFromMemory, MergeField, Save, SaveToMemory, Twips2Pixels
DocumentServer.DocumentController.FieldAdapterCollection	Count, Item	CopyTo, GetEnumerator, IndexOf
DocumentServer.Fields.DateField	Date, Format, Text
DocumentServer.Fields.FieldAdapter	ApplicationField, ID, Length, Start, TypeName	ShowDialog
DocumentServer.Fields.FormCheckBox	Checked, Size, SizeAuto
DocumentServer.Fields.FormDropDown	ListEntries
DocumentServer.Fields.FormFieldAdapter	Bounds, CalcOnExit, Enabled, Font, HelpText, Name, StatusText, Text
DocumentServer.Fields.FormText	Format, MaxLength, Type
DocumentServer.Fields.IfField	Expression1, Expression2, FalseText, FieldValue, Operator, Text, TrueText
DocumentServer.Fields.IncludeText	Bookmark, Filename, TextFormat
DocumentServer.Fields.MailMergeFieldAdapter	PreserveFormatting
DocumentServer.Fields.MergeField	Mapped, Name, Text, TextAfter, TextBefore, TextFormat, VerticalFormatting
DocumentServer.MailMerge	SearchPath		FieldMerged, IncludeTextMerging
DocumentServer.MailMerge.BlockRowMergedEventArgs	DataRowCount, MergeBlockName
DocumentServer.MailMerge.FieldMergedEventArgs	Cancel, MailMergeFieldAdapter, Merged
DocumentServer.MailMerge.IncludeTextMergingEventArgs	Filename, IncludeTextDocument
DocumentTarget	Bounds
FontSettings	AdaptFontEvent, EmbeddableFontsOnly, ScalableFontsOnly, TrueTypeFontsOnly
HeaderFooter	Paragraphs
ListFormat	TextAfterNumber, TextBeforeNumber
LoadSettings	PDFImportSettings
Page		GetImage
Paragraph	Format, FormattingStyle, Length, Lines, ListFormat, ListNumber, ListNumberText, Number, Start, StartLine, Text	Save, Select
ParagraphCollection	Count, Item	CopyTo, GetEnumerator, GetItem
SectionFormat	ColumnDistances, ColumnLineColor, ColumnLineWidth, Columns, ColumnWidths, EqualColumnWidth
ServerTextControl	FontSettings, Paragraphs	OnAdaptFont	AdaptFont
TextField	Bounds, Deleteable, DoubleClickEvent, DoubledInputPosition, Editable, FormattingBounds, ID, Length, Name, ShowActivated (obsolete), Start, Text	ScrollTo
TextFrame	Paragraphs

Next Steps

Version 15.1: the features of the next version.
Version 14.0: sections, DOCX, MS Word fields and the first MailMerge component.
PDF/A: create archivable PDF documents today.

What's New in TX Text Control 15.0