# Integrating TX Spell .NET for Windows Forms

> Add TX Spell .NET to a Windows Forms TextControl: TXSpell.WinForms.SDK package, TXSpellChecker component, SpellChecker property, several editors, deployment.

- **Product:** TX Text Control .NET for Windows Forms
- **Section:** Documentation
- **Kind:** Topic
- **Path:** TX Text Control .NET for Windows Forms > Integration Guide > Integrating TX Spell .NET for Windows Forms
- **1828 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/integration/tx-spell/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/integration/tx-spell/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/integration/tx-spell/llms-full.txt

---

TX Spell .NET for Windows Forms is the spell checker of TX Text Control: a separate product of Text Control that brings the dictionaries, hyphenation lists and synonyms the `TextControl` lacks. Adding it to an application that already uses TX Text Control takes a package, a component and one property. The checklist below covers the whole integration -- installation, licensing, the connection, several editors and deployment -- and points to the TX Spell .NET documentation, which describes every feature in detail.

### What Each Product Contributes

|  | TX Text Control .NET for Windows Forms | TX Spell .NET for Windows Forms |
|---|---|---|
| Package | `TXTextControl.TextControl.WinForms.SDK` 34.0.5 | `TXTextControl.TXSpell.WinForms.SDK` 11.0.1 |
| In the toolbox | The tab **TX Text Control 34.0** | The tab **TXSpell 11.0**, with the component `TXSpellChecker` |
| At run time | The red underlines, the context menu of misspelled words, the spelling dialog, the **Proofing** ribbon tab and hyphenation at the end of a line | The words: US English dictionary, hyphenation list, synonym list and language recognition, and further languages you add |

The `TextControl` has the members that display the results, such as [IsSpellCheckingEnabled](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/textcontrol/isspellcheckingenabled-property/llms-full.txt) and [IsHyphenationEnabled](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/textcontrol/ishyphenationenabled-property/llms-full.txt). [Spell Checking and Hyphenation](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/document-editor/spell-checking/llms-full.txt) lists them and shows what the user sees.

### Install and License Both Products

TX Spell .NET is installed, licensed and updated independently of TX Text Control:

1. Install the setup of TX Spell .NET for Windows Forms, the full or the trial version. Like the setup of TX Text Control, it adds its package to **Text Control Offline Packages**. See [Installing the Product](https://docs.textcontrol.com/tx-spell-dotnet-winforms/installation/setup/llms-full.txt).
2. In your project, choose **Project** > **Manage NuGet Packages...**, select **Text Control Offline Packages** as the package source and install `TXTextControl.TXSpell.WinForms.SDK`.
3. Build the project. The package embeds its own license file, *txspell.winforms.license*, into your assembly, next to the one of TX Text Control.

TX Spell .NET 11.0 was released together with TX Text Control 33.0 and is the version to use with TX Text Control 34.0. Plan upgrades of both products together; [Upgrading from Previous Versions](https://docs.textcontrol.com/tx-spell-dotnet-winforms/installation/upgrading/previous-versions/llms-full.txt) lists what changes.

### Connect the Spell Checker

The `TXSpellChecker` component connects to the editor through [SpellChecker](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/textcontrol/spellchecker-property/llms-full.txt), a property of the `TextControl` that holds the component itself:

1. Open the form in the designer and drag **TXSpellChecker** from the tab **TXSpell 11.0** onto it. As a component, it appears in the component tray below the form as `txSpellChecker1`.
2. Select `textControl1` and choose **txSpellChecker1** in the drop-down of **SpellChecker** in the **Properties** window:

    ![The Properties window of textControl1 with the SpellChecker drop-down open, offering (none) and txSpellChecker1.](https://docs.textcontrol.com/assets/img/tx-text-control-dotnet-winforms/properties-spellchecker.9fdad44f.webp)
3. Set **IsSpellCheckingEnabled** to **True**, and **IsHyphenationEnabled** to **True** if lines should be hyphenated.

The same connection in code, in the constructor of the form after `InitializeComponent`:

```csharp
// Connect TX Spell .NET and check as the user types
textControl1.SpellChecker = txSpellChecker1;
textControl1.IsSpellCheckingEnabled = true;
textControl1.IsHyphenationEnabled = true;
```

The `TextControl` initializes a connected spell checker itself. Press **F5** and type a misspelled word: it gets a red zigzag line, a right-click on it shows suggestions, and the buttons of a **Proofing** tab, a [RibbonProofingTab](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonproofingtab/llms-full.txt), work as soon as the spell checker is connected. [What the User Sees](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/document-editor/spell-checking/#what-the-user-sees) shows the context menu, the tab and the spelling dialog. [Create Your First Windows Forms Application](https://docs.textcontrol.com/tx-spell-dotnet-winforms/getting-started/tx-text-control/first-application/llms-full.txt) in the TX Spell .NET documentation builds such a form step by step.

### Several Editors, One Spell Checker

One `TXSpellChecker` serves every `TextControl` of a form: set the `SpellChecker` property of each editor to the same component. The dictionaries are loaded once, and a word the user adds to the dictionary in one editor is accepted in all others. For editors created in code, as in [Embedding the Editor in Forms and UserControls](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/integration/embedding/llms-full.txt), connect each new editor when you create it:

```csharp
// Every new editor uses the spell checker of the form
TextControl editor = new TextControl() { Dock = DockStyle.Fill };
editor.SpellChecker = txSpellChecker1;
editor.IsSpellCheckingEnabled = true;
```

The **Multiple controls** sample of TX Spell .NET, which the setup installs in the folder *Samples\\WinForms\\CSharp\\TextControl\\Multiple controls* of its samples, connects four editors of one form to the same `TXSpellChecker`. Each one underlines its misspelled words and offers the same suggestions:

![A Windows Forms sample with four TextControls in a grid, all with underlined misspelled words, and the context menu of one of them with suggestions for the word sampke.](https://docs.textcontrol.com/assets/img/tx-text-control-dotnet-winforms/spell-check-several-editors.0b87ecfe.webp)

[Checking Multiple Controls](https://docs.textcontrol.com/tx-spell-dotnet-winforms/spell-checking/multiple-controls/llms-full.txt) also shows one spelling dialog that works through several editors.

### Deploy the Application

With the package, the build copies the assemblies of TX Spell .NET, *TXSpell.dll* and *TXSpell.Windows.Forms.dll*, and the folders *Dictionaries*, *HyphenationLists*, *SynonymLists* and *LanguageRecognition* into the output folder, and **Publish** copies them into the publish folder. Deploy them together with the files of TX Text Control, which [Managed Assemblies and Native Libraries](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/deployment/assemblies/llms-full.txt) lists. The package contains US English only; other languages are downloaded separately, as [Installing Dictionaries and Language Data](https://docs.textcontrol.com/tx-spell-dotnet-winforms/installation/language-data/llms-full.txt) describes. [Deployment Guide](https://docs.textcontrol.com/tx-spell-dotnet-winforms/deployment/llms-full.txt) in the TX Spell .NET documentation covers the rest.

### Where to Continue

The TX Spell .NET documentation describes each part of the integration:

| Task | Read |
|---|---|
| Every member of the `TextControl` that works with TX Spell .NET | [TX Text Control .NET for Windows Forms](https://docs.textcontrol.com/tx-spell-dotnet-winforms/integration/tx-text-control/llms-full.txt) |
| Load dictionaries for other languages | [Loading and Managing Dictionaries](https://docs.textcontrol.com/tx-spell-dotnet-winforms/dictionaries/managing/llms-full.txt) |
| Change the spelling dialog and the context menu | [Spell Check Dialog](https://docs.textcontrol.com/tx-spell-dotnet-winforms/user-interface/spell-check-dialog/llms-full.txt), [Context Menus](https://docs.textcontrol.com/tx-spell-dotnet-winforms/user-interface/context-menus/llms-full.txt) |
| Hyphenate documents | [Hyphenation with TX Text Control](https://docs.textcontrol.com/tx-spell-dotnet-winforms/hyphenation/tx-text-control/llms-full.txt) |
| Solve problems with dictionaries or licenses | [Troubleshooting](https://docs.textcontrol.com/tx-spell-dotnet-winforms/troubleshooting/llms-full.txt) |

### Next Steps

- [Spell Checking and Hyphenation](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/document-editor/spell-checking/llms-full.txt): the spell checking members of the `TextControl`, and a spell checker of your own.
- [TX Spell .NET for Windows Forms](https://docs.textcontrol.com/tx-spell-dotnet-winforms/llms-full.txt): the documentation of the spell checker.
- [Visual Studio Designer Integration](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/integration/designer/llms-full.txt): connect components in the **Properties** window.

---

## Nearby

- **Previous:** [Integrating Existing Menus and Toolbars](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/integration/menus-toolbars/llms-full.txt)
- **Next:** [Integrating Charts and Barcodes](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/integration/charts-barcodes/llms-full.txt)