wpf-119533-controls-and-libraries-spell-checker-examples-how-to-bind-dictionaries-to-the-spell-checker-in-mvvm-applications.md
This topic explains how to use the MVVM approach to manage Spell Checker integrated into a text-aware control. This approach allows you to handle spell-checker events or store dictionary files in a database.
If your application does not require tracking user interaction or UI customization, you can add a spell checking behavior and manage it in XAML. Refer to the following article for more information: Configure Spell-Checking Behavior.
You can use the SpellingSettings option to integrate the Spell Checker into a supported text-aware control.
In the ViewModel class, create a SpellChecker class instance and specify its Culture, SpellingFormType, and SpellCheckMode properties.
using DevExpress.Mvvm;
using DevExpress.Xpf.SpellChecker;
using DevExpress.XtraSpellChecker;
// ...
public class MainViewModel
{
// ...
public virtual SpellChecker SpellChecker { get; set; }
// ...
{
// Create a SpellChecker class instance.
SpellChecker = new SpellChecker();
// Specify the SpellChecker's properties.
SpellChecker.SpellingFormType = SpellingFormType.Word;
SpellChecker.SpellCheckMode = SpellCheckMode.AsYouType;
SpellChecker.Culture = new CultureInfo("de-DE");
// ...
}
Imports DevExpress.Xpf.SpellChecker
' ...
Imports DevExpress.XtraSpellChecker
' ...
Public Class MainViewModel
Public Overridable Property Dictionaries As DictionarySourceCollection
Public Overridable Property SpellChecker As SpellChecker
Public Sub New()
' Create a SpellChecker class instance.
SpellChecker = New SpellChecker()
' Specify the SpellChecker's properties.
SpellChecker.SpellingFormType = SpellingFormType.Word
SpellChecker.SpellCheckMode = SpellCheckMode.AsYouType
SpellChecker.Culture = New CultureInfo("de-DE")
' ...
End Sub
In XAML, add references to the following namespaces:
xmlns:ViewModel="clr-namespace:DXSpellCheckerBindingDictionaries.ViewModel"
xmlns:dxsch="http://schemas.devexpress.com/winfx/2008/xaml/spellchecker"
Bind the attached SpellingSettings.SpellChecker property to the created SpellChecker object to enable spell check for a text editor. You can bind this property at the level of the root container to enable this functionality for its children.
<Grid dxsch:SpellingSettings.SpellChecker="{Binding SpellChecker}"
dxsch:SpellingSettings.CheckAsYouType="True"
dxsch:SpellingSettings.ShowSpellCheckMenu="True"
dxsch:SpellingSettings.UnderlineColor="Blue"
dxsch:SpellingSettings.UnderlineStyle="WavyLine"
dxsch:SpellingSettings.DictionarySourceCollection="{Binding Dictionaries, UpdateSourceTrigger=PropertyChanged}">
Create a DictionarySourceCollection Dictionaries property to bind dictionaries. Create a new DictionarySourceCollection and add a new dictionaries to it. Specify the dictionary file, the affix file, and the culture settings of the dictionary.
public class MainViewModel
{
public virtual DictionarySourceCollection Dictionaries { get; set; }
// ...
public MainViewModel()
{
// ...
Dictionaries = GetDictionaries();
// ...
}
// ...
public DictionarySourceCollection GetDictionaries()
{
// Create a dictionary collection.
var collection = new DictionarySourceCollection();
// Create a Hunspell spell-checking dictionary.
var dictionary = new HunspellDictionarySource() { Culture = new CultureInfo("de-DE") };
// Load the dictionary file.
dictionary.DictionaryUri = new Uri(@"pack://application:,,,/DXSpellCheckerBindingDictionaries;component/Dictionaries/de_DE.dic");
// Load the affix file.
dictionary.GrammarUri = new Uri(@"pack://application:,,,/DXSpellCheckerBindingDictionaries;component/Dictionaries/de_DE.aff");
// Add the dictionary to the collection.
collection.Add(dictionary);
var customDictionary = new SpellCheckerCustomDictionarySource() { Culture = new CultureInfo("EN-us") };
customDictionary.DictionaryUri = new Uri(@"pack://application:,,,/DXSpellCheckerBindingDictionaries;component/Dictionaries/CustomEnglish.dic");
customDictionary.AlphabetUri = new Uri(@"pack://application:,,,/DXSpellCheckerBindingDictionaries;component/Dictionaries/Alphabet.txt");
collection.Add(customDictionary);
return collection;
}
Public Class MainViewModel
Public Overridable Property Dictionaries As DictionarySourceCollection
Public Overridable Property SpellChecker As SpellChecker
Public Sub New()
' ...
Dictionaries = GetDictionaries()
End Sub
Public Function GetDictionaries() As DictionarySourceCollection
' Create a dictionary collection.
Dim collection = New DictionarySourceCollection()
' Create a Hunspell spell-checking dictionary.
Dim dictionary = New HunspellDictionarySource()
' Specify the dictionary culture settings.
dictionary.Culture = New CultureInfo("de-DE")
' Load the dictionary file.
dictionary.DictionaryUri = New Uri("pack://application:,,,/DXSpellCheckerBindingDictionaries;component/Dictionaries/de_DE.dic")
' Load the affix file.
dictionary.GrammarUri = New Uri("pack://application:,,,/DXSpellCheckerBindingDictionaries;component/Dictionaries/de_DE.aff")
' Add the dictionary to the collection.
collection.Add(dictionary)
Return collection
End Function
End Class
In XAML, bind the SpellingSettings.DictionarySourceCollection to the Dictionaries property:
<Grid dxsch:SpellingSettings.SpellChecker="{Binding SpellChecker}"
dxsch:SpellingSettings.CheckAsYouType="True"
dxsch:SpellingSettings.ShowSpellCheckMenu="True"
dxsch:SpellingSettings.UnderlineColor="Blue"
dxsch:SpellingSettings.UnderlineStyle="WavyLine"
dxsch:SpellingSettings.DictionarySourceCollection="{Binding Dictionaries, UpdateSourceTrigger=PropertyChanged}">
Subscribe to and handle spell checker events in the ViewModel class. Refer to the following table for a complete list of available events: SpellChecker Events
The following code snippet handles the SpellingFormShowing and RepeatedWordFound events:
{
// ...
// Subscribe to events
SpellChecker.RepeatedWordFound += SpellChecker_RepeatedWordFound;
SpellChecker.CheckCompleteFormShowing += SpellChecker_CheckCompleteFormShowing;
}
private void SpellChecker_CheckCompleteFormShowing(object sender, FormShowingEventArgs e)
{
MessageBoxService.Show("That's It!");
e.Handled = true;
}
private void SpellChecker_RepeatedWordFound(object sender, RepeatedWordFoundEventArgs e)
{
e.Result = SpellCheckOperation.Cancel;
}
Public Sub New()
' Subscribe to events
AddHandler SpellChecker.RepeatedWordFound, AddressOf SpellChecker_RepeatedWordFound
AddHandler SpellChecker.CheckCompleteFormShowing, AddressOf SpellChecker_CheckCompleteFormShowing
End Sub
Private Sub SpellChecker_CheckCompleteFormShowing(ByVal sender As Object, ByVal e As FormShowingEventArgs)
MessageBoxService.Show("That's It!")
e.Handled = True
End Sub
Private Sub SpellChecker_RepeatedWordFound(ByVal sender As Object, ByVal e As RepeatedWordFoundEventArgs)
e.Result = SpellCheckOperation.Cancel
End Sub
This example uses the DXMessageBoxService to show a message. Register this service in XAML:
<dxmvvm:Interaction.Behaviors>
<dx:DXMessageBoxService />
</dxmvvm:Interaction.Behaviors>
See Also