# Troubleshooting

> Solve problems with TX Text Control .NET for Windows Forms: packages, the toolbox, licenses, native libraries, fonts, DPI, printing, conversion and deployment.

- **Product:** TX Text Control .NET for Windows Forms
- **Section:** Documentation
- **Kind:** Topic
- **Path:** TX Text Control .NET for Windows Forms > Troubleshooting
- **1264 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/llms-full.txt

---

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 see | Read |
|---|---|
| A package isn't found, doesn't install or doesn't fit the target framework | [Installation and Package Restore](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/installation/llms-full.txt) |
| The toolbox tab is missing, or the designer doesn't work as described | [Toolbox and Designer](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/toolbox/llms-full.txt) |
| "The following control could not be licensed", an expired trial or a `LicenseLevelException` | [Licensing](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/licensing/llms-full.txt) |
| "The TX Text Control kernel DLL file could not be found", or the application fails when the engine starts | [Native Libraries and Architecture Mismatches](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/native-libraries/llms-full.txt) |
| Text in another font, moved line and page breaks, or a PDF/A document that can't be saved | [Fonts and Document Layout](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/fonts/llms-full.txt) |
| A blurry or wrongly scaled editor on a high-resolution display or a second monitor | [High DPI and Scaling](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/dpi-scaling/llms-full.txt) |
| Printing is disabled, prints the wrong pages or looks different from the screen | [Printing](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/printing/llms-full.txt) |
| A `FilterException`, or a loaded or converted document that looks wrong | [Document Conversion](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/conversion/llms-full.txt) |
| Merge fields or blocks that stay empty or disappear | [Mail Merge](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/mail-merge/llms-full.txt) |
| An application that runs on your machine but not on the machine of a user | [Deployment](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/deployment/llms-full.txt) |

### Collect the Evidence First

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

- **The version and edition.** `GetVersionInfo` returns the edition and the service pack the application runs with. See [Check Which Edition Your Application Runs](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/licensing/#check-which-edition-your-application-runs).
- **The reason of an exception.** A `FilterException` names its cause in its `Reason` property and an error number in its message. See [Read the Reason of a FilterException](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/conversion/#read-the-reason-of-a-filterexception).
- **The replaced fonts.** The `AdaptFont` event reports every font that isn't available. See [Find Out Which Fonts Are Replaced](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/fonts/#find-out-which-fonts-are-replaced).
- **The bitness of the process.** Whether the application runs as a 32-bit or a 64-bit process decides which native libraries it needs. See [The Application Runs With the Wrong Bitness](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/native-libraries/#the-application-runs-with-the-wrong-bitness).

### 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](https://www.textcontrol.com/product/tx-text-control-dotnet-winforms/issue/3400/). 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](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/licensing/#check-which-edition-your-application-runs) and [Service Packs](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/whats-new/service-packs/#check-the-installed-service-pack) 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](https://www.textcontrol.com/contact/). A subscription includes technical support by email, telephone and chat, with no limit on the number of incidents; see [Subscription and Updates](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/overview/licensing/#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](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/installation/llms-full.txt), then [Toolbox and Designer](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/toolbox/llms-full.txt) and [Licensing](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/licensing/llms-full.txt).
2. **The application fails on another machine:** [Deployment](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/deployment/llms-full.txt) first, then [Native Libraries and Architecture Mismatches](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/native-libraries/llms-full.txt).
3. **Documents look wrong:** [Fonts and Document Layout](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/fonts/llms-full.txt) first, then [Document Conversion](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/conversion/llms-full.txt).
4. **Nothing on these pages matches:** check the [known issues](#check-the-known-issues) of your version.

If a problem started after an update, check the [Breaking Changes](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/whats-new/breaking-changes/llms-full.txt) of the versions you skipped. The [Deployment Guide](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/deployment/llms-full.txt) shows complete setups that avoid many of these problems.

---

## In This Section

- [Document Conversion](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/conversion/llms-full.txt): Solve loading and saving problems in TX Text Control .NET for Windows Forms: FilterException reasons, wrong formats, protected PDFs, missing images and fields.
- [Deployment](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/deployment/llms-full.txt): Fix deployment problems of TX Text Control .NET for Windows Forms: missing files, files in the wrong folder, published apps without native libraries, MSIX.
- [High DPI and Scaling](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/dpi-scaling/llms-full.txt): Fix blurry or wrongly scaled editors in TX Text Control .NET for Windows Forms: DPI awareness, per-monitor scaling in app.config or Program.cs, ribbon icons.
- [Fonts and Document Layout](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/fonts/llms-full.txt): Fix font problems in TX Text Control .NET for Windows Forms: replaced fonts, layout that changes between machines and printers, and fonts that block PDF/A.
- [Installation and Package Restore](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/installation/llms-full.txt): Fix NuGet problems of TX Text Control .NET for Windows Forms: missing packages, feed tokens, target frameworks, CI builds, service packs and migration to .NET.
- [Licensing](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/licensing/llms-full.txt): Fix license errors of TX Text Control .NET for Windows Forms: controls that could not be licensed, licenses.licx, class libraries, the trial and editions.
- [Mail Merge](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/mail-merge/llms-full.txt): Fix mail merge problems in TX Text Control .NET for Windows Forms: empty or vanishing fields, blocks that don't repeat, empty lines, formats and exceptions.
- [Native Libraries and Architecture Mismatches](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/native-libraries/llms-full.txt): Fix native library errors of TX Text Control .NET for Windows Forms: the kernel DLL not found, 32-bit and 64-bit mismatches, the Visual C++ runtime and Create.
- [Printing](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/printing/llms-full.txt): Fix printing problems of TX Text Control .NET for Windows Forms: disabled printing, wrong page ranges, the status dialog, breaks that differ and slow start.
- [Toolbox and Designer](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/toolbox/llms-full.txt): Fix toolbox and designer problems of TX Text Control .NET for Windows Forms: a missing toolbox tab, the private feed package, smart tags and old versions.

---

## Nearby

- **Previous:** [Performance Best Practices](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/performance/best-practices/llms-full.txt)
- **Next:** [Installation and Package Restore](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/troubleshooting/installation/llms-full.txt)
