TX Text Control .NET for Windows Forms

Troubleshooting

Topic

A package isn't found, a control can't be licensed, text shows up in another font or the application fails on the machine of a user. What you see usually tells you where to look, and each page of Troubleshooting starts from such a symptom, quotes the message where TX Text Control shows one, explains the cause and gives the steps that fix it.

Find the Right Page

If you seeRead
A package isn't found, doesn't install or doesn't fit the target frameworkInstallation and Package Restore
The toolbox tab is missing, or the designer doesn't work as describedToolbox and Designer
"The following control could not be licensed", an expired trial or a LicenseLevelExceptionLicensing
"The TX Text Control kernel DLL file could not be found", or the application fails when the engine startsNative Libraries and Architecture Mismatches
Text in another font, moved line and page breaks, or a PDF/A document that can't be savedFonts and Document Layout
A blurry or wrongly scaled editor on a high-resolution display or a second monitorHigh DPI and Scaling
Printing is disabled, prints the wrong pages or looks different from the screenPrinting
A FilterException, or a loaded or converted document that looks wrongDocument Conversion
Merge fields or blocks that stay empty or disappearMail Merge
An application that runs on your machine but not on the machine of a userDeployment

Collect the Evidence First

Most problems are quicker to solve with the right information at hand:

Check the Known Issues

Text Control keeps a list of known issues for each major version, on the page Known Issues of TX Text Control .NET for Windows Forms 34.0. It names each issue with its ID and area, groups the closed issues by the service pack that fixed them, and lists the issues that are still open. The service pack announcements on the blog link the same page.

  1. Read the service pack your application runs with, as Check Which Edition Your Application Runs and Service Packs show.
  2. Look for your problem on the page. If a later service pack fixed it, install that service pack, update the package and rebuild the application.
  3. If the issue is open, it isn't fixed yet in any service pack of the version.

For an earlier major version, replace 3400 in the address with its number, such as 3300 for version 33.0.

Contact Text Control Support

When neither these pages nor the known issues solve the problem, contact Text Control through the contact page. A subscription includes technical support by email, telephone and chat, with no limit on the number of incidents; see Subscription and Updates. Send the evidence listed above with your request: the version, the edition, the service pack and the complete message with its error number.

Where to Start

  1. A new project doesn't build or run: start with Installation and Package Restore, then Toolbox and Designer and Licensing.
  2. The application fails on another machine: Deployment first, then Native Libraries and Architecture Mismatches.
  3. Documents look wrong: Fonts and Document Layout first, then Document Conversion.
  4. Nothing on these pages matches: check the known issues of your version.

If a problem started after an update, check the Breaking Changes of the versions you skipped. The Deployment Guide shows complete setups that avoid many of these problems.