Show language: C# VB.NET Both

RapidSpell Desktop and Thesaurus Desktop Integration With TX Text Control

This article is for TX v13 and earlier, please see this article for TX v14.

Integration of RapidSpell and Thesaurus with TX Text Control can be as simple as dragging controls on to the Form and setting two properties in the property editor - however, TX Text Control is a powerful word processor component, and full integration of spell checking can be a little more complex with some subtle points to consider. This article intends to show how to achieve full integration, and will address commonly asked questions about this subject.

To show fullest usage of spell checking and thesaurus with TX Text Control we have started from the "TX Text Control Words" demo project distributed with TX Text Control. The following demonstrates nearly all requirements customers have faced. This article is aimed at TX Text Control 12 & 13 Professional (Pro is required for headers/footers/text-frames) - however it can easily be adapted for 10, 11 and non Professional versions. Support for TX 13 was added in RapidSpell Desktop 3.7 and Thesaurus Desktop 1.1.0.

Downloads:

These projects show complete integration with both RapidSpell Desktop .NET and Thesaurus Desktop .NET, and therefore require both to be installed in order to run properly.
TX v13 C# Demo Project
TX v13 VB.NET Demo Project

TX v12 C# Demo Project
TX v12 VB.NET Demo Project

1. RapidSpell Setup

a) Add references to Keyoti.RapidSpell.TXSupportv13.dll and Keyoti.RapidSpellMDict.dll Starting from the "TX TextControl Words" the only things that need to be done are adding references in the project to Keyoti.RapidSpell.TXSupportv13.dll and Keyoti.RapidSpellMDict.dll (found in C:\Program Files\Keyoti Inc\RapidSpell Desktop .NET\3rd Party DLLs)

b) You may want to add controls from Keyoti.RapidSpell.TXSupportv13.dll to your tool box (right click toolbox, add/remove items, browse for Keyoti.RapidSpell.TXSupportv13.dll). Note, you must not have a reference to Keyoti.RapidSpell.dll in your project.

Note if you added items to your toolbox from the Keyoti.RapidSpell.dll, you will find that when dragging controls from the toolbox, that a reference is added to the Keyoti.RapidSpell.dll, this is OK, but remember to remove the reference from your project references

2. Adding RapidSpellAsYouType to TX Text Control

To begin with, as-you-type support will be added without concern for headers/footers/text-frames or context menus. In the "TX Text Control Words" demo project the TXTextControl.TextControl Control is located in the frmMDIChild Form.

a) Drag the RapidSpellAsYouType control from the toolbox on to the frmMDIChild Form.

b) Drag the TXTextControlAdapter control from the toolbox on to the form.

c) The simplest way to configure RapidSpellAsYouType in the designer's property editor is to first set TXTextControlAdapter.TextControl to the instance of TextControl, and then set RapidSpellAsYouType.TextComponent to the instance of TXTextControlAdapter. However, see the ContextMenu section for important points.

2.1 Working with existing ContextMenus

+ Expand

2.2 Working with Headers/Footers/Text-frames

+ Expand

2.3 Loading & Saving Documents

+ Expand

3. Adding RapidSpellDialog to TX Text Control

There are two ways to do this, the first way below is if you are not working with headers/footers or text-frames, the second way continues on from the as-you-type integration instructions above.

3.1 Simple, no headers/footers or text frames

+ Expand

3.2 Full, integration with headers/footers and text frames

+ Expand

4. Thesaurus Setup

Thesaurus Desktop .NET is a separate download to RapidSpell.

a) Add references to Keyoti.Thesaurus.TXTextControlAdapter.v13.dll and Keyoti.Thesaurus.Windows.DLL (found in C:\Program Files\Keyoti Inc\Thesaurus Desktop .NET)

b) You may want to add controls from both DLLs to your tool box (right click toolbox, add/remove items, find controls named Thesaurus, Thesaurus Control and ThesaurusTXAdapter). Note, be sure to select the TX adapter control for the correct version; You will see two controls in the list, one from Keyoti.Thesaurus.TXTextControlAdapter.v12.dll and one from Keyoti.Thesaurus.TXTextControlAdapter.v13.dll - if you pick v12 you will get references added to your project which are dependent on TX v12.

5. Adding Thesaurus to TX Text Control

5.1 Simple, dialog based thesaurus

+ Expand

5.2 Full, context menu and dialog based thesaurus

+ Expand

Conclusion

We hope that this article has shed light on how to achieve more advanced integration requirements. If you have questions or problems please feel free to email support@keyoti.com for assistance.

Downloads:

These projects show complete integration with both RapidSpell Desktop .NET and Thesaurus Desktop .NET, and therefore require both to be installed in order to run properly.
TX v13 C# Demo Project
TX v13 VB.NET Demo Project

TX v12 C# Demo Project
TX v12 VB.NET Demo Project















© Copyright 2005-2008 Keyoti Inc.