TX Text Control: Alternative Rendering of RTF Content in List & Label

Klicke hier für den deutschen Artikel.

Valid from List & Label 21

The RTF object, which is fully integrated into List & Label, is based on the Microsoft RTF control installed on the Windows system, which is also used by Microsoft WordPad, for example. Multiple different versions of the control may be installed on the same Windows system. List & Label allows you to force the version of the RTF Control to be used via the LL_OPTION_MAXRTFVERSION option (or the component’s .MaxRTFVersion property). However, the different RTF versions behave differently, which can also affect any List & Label reports. In addition, the feature set of the Microsoft RTF control is severely limited, particularly in the area of table display.

As an alternative, List & Label allows you to use the RTF control TX Text Control .NET for Windows Forms from Text Control GmbH as a standalone designer object, provided you have a license for the control. This enables you to directly use RTF text rendered with the TX Text Control in List & Label reports within your own application. The List & Label installation includes a .NET sample demonstrating the use of the control. You can find the sample in the List & Label installation in the subdirectory “..\Samples\Microsoft .NET\[.NET Version]\WinForms\TX Text Control Sample\”. Important information about the sample can be found in the sample’s readme.txt file.

Requirements and Usage

  • The programming example uses C# / Visual Studio
  • TX Text Control .NET for Windows Forms must be installed - at least version 22.0 Professional/Enterprise
  • List & Label must be installed - at least version 21, including Service Pack 21.002

General Notes

  • Up to version 23, the List & Label Designer object ‘TXDesignerControl’ can only be used in .NET - not in unmanaged environments such as C++. Starting with version 23, you can also use the object in other programming languages via the DesignerObjectBridge.
  • Any headers and footers in the RTF text of a TX Text Control are not supported or are ignored.
  • When using RTF tables, the system attempts to display the layout 1:1 by default. However, if the object is smaller or narrower than the original table or the RTF document, clipping effects may occur. For this purpose, the ‘RecalcTableLayout’ property of the Designer object is available to force the table in the RTF document to be adjusted to fit the smaller space. If this option is enabled, however, it affects performance, as recalculating the given layout is computationally intensive and may modify the table’s layout.
  • The included sample document ‘Great-Team.rtf’ also uses List & Label formulas/fields and supports them accordingly. These are evaluated during printing, which may have a minor impact on performance. The sample document ‘debwin.rtf’ does not use List & Label formulas/fields.

The example is provided “as is” as part of the installation and can be adapted at any time to meet your specific needs. If you notice any improvements, have suggestions, or even find any errors, please feel free to let us know - we welcome your ideas.

IDKBAE001309 KBAE001309