Spell Checking

  • 3 minutes to read

The RichEditControl uses the Spell Checker component to implement the spell checking functionality.

Follow the steps below to add a spell checker to your application.

Add the SpellChecker component

The SpellChecker is added automatically when the RichEditControl application is created using the Template Gallery. Drag the SpellChecker component icon from Visual Studio's toolbox onto the form to add the SpellChecker to the application manually. The RichEditControl.SpellChecker property is set once the component is placed onto the form.

XtraRichEdit_SpellChecker_AddFromToolbox

NOTE

When the RichEditControl is used as a repository editor in XtraGrid, spelling suggestions could be missing from the context menu if the RichEditorControl is not on the same form as the SpellChecker. To avoid this, force menu creation by calling the SpellChecker.SetShowSpellCheckMenu method within the ColumnView.ShownEditor event.

Add Dictionaries

Add one of the following dictionaries:

Dictionary Culture

The SpellCheckerOptions.AutoDetectDocumentCulture property determines whether the SpellChecker automatically detects current text's culture (returned by the CharacterPropertiesBase.Language property) and selects the corresponding dictionary. If the AutoDetectDocumentCulture property is false and the SpellCheckerBase.Culture is set to "En-US", the SpellChecker uses the English dictionary to check spelling.

When you add dictionaries and set the AutoDetectDocumentCulture property to false, the SpellChecker uses dictionaries that correspond with the SpellCheckerBase.Culture property. Set the Culture property to Invariant to use all dictionaries.

Specify the SpellChecker options

Fine-tune the spell checker. Use one of the following properties to specify the spell checker's options:

API Description
SpellChecker.OptionsSpelling Provides access to the OptionsSpelling instance that contains options that affect text processing.
RichEditControlOptionsBase.SpellChecker Obtains a SpellCheckerOptions object containing options that specify how the spell checker should process text in any document range.
SpellChecker.SpellCheckMode Gets or sets the XtraSpellChecker's operation mode.
SpellCheckerBase.SpellingFormType Gets or sets the type of form that is shown when a possible misspelled word is found.
NOTE

SpellChecker.CheckAsYouTypeOptions property does not affect the RichEditControl.

Result

End users can use the Spelling item on the Review ribbon tab to check the document's spelling. The invoked Spelling Dialog allows you to select the misspelled word's replacement, skip it or add it to the dictionary.

The SpellCheckMode.AsYouType mode underlines misspelled words. End users can right-click these words and replace them with a suggestion from the context menu or invoke the Spelling Dialog by clicking the Spelling item.

RichEdit_SpellChecker

NOTE

The SpellChecker does not underline misspelled words in multiple controls at the same time. Words are underlined in the focused control only. Use the SpellChecker.CheckContainer method to check spelling in multiple controls at once on demand.

See Also