Setting up dictionary files

Dictionary files for at least one language must be present before the SpellChecker control can be used. Follow these steps to setup the dictionary files:

1. Add a new appSettings entry "eo_DictLocation" into your web.config to info the SpellChecker the location of the dictionary files. For example:
   web.config

   Copy

   <appSettings>
       <add key="eo_DictLocation" value="~/eo_dict"></add>
   </appSettings>

2. Download dictionary files for the desired language. EO.Web SpellChecker uses OpenOffice dictionary files. Follow these steps to download OpenOffice dictionary files:

   • Open Office Extension Repository page at http://extensions.openoffice.org/;
   • Search for the dictionary extension. For example, you can search for "french dictionary";
   • Download the extension. The extension has an "oxt" file extension, but in fact it is a zip file;
   • Use any zip utility to unzip the downloaded .oxt file;
   • Find the .dic and .aff file. These two files are the dictionary files;
3. Create a sub directory for that language under the directory specified by "eo_DictLocation" appSettings entry. The sub directory name must be the same as the locale name. For example, en-US for U.S. English. List of valid locale names can be found here on MSDN;

Using SpellChecker control

Follow the simple steps outlined below to start using EO.Web SpellChecker. Note these steps describe how to use SpellChecker with a SpellCheckerDialog. For information on how to use SpellChecker with a ContextMenu, see here.

1. Drag a SpellChecker and a SpellCheckerDialog control from the toolbox onto the form;
2. Right click the dialog, select Edit Dialog... to initialize the dialog with a built-in template. You can also design your own appearance settings;
3. Modify the dialog's HeaderHtml and FooterHtml to the desired value. HeaderHtml is usually set to a text that indicates the purpose of the dialog, while FooterHtml is usually set to blank;
4. Set the SpellChecker's ControlToCheck property to indicate the control whose text is to be checked;
5. Set the SpellChecker's DialogID property to the ID of the SpellCheckerDialog control;
6. Optional. Set the SpellChecker's Language property to the desired value;
7. Either set the SpellChecker's StartButton so that clicking the button can start the spell checker, or add code that calls the SpellChecker's start method on the client side to initiate the spell check;
8. Run the page and start the spell check. If there are no errors, a "no error" message is displayed; otherwise the dialog is displayed with options to correct the errors.