syncfusion-winforms-spell-checker

Syncfusion Windows Forms SpellChecker の実装

SpellCheckerAdv コントロールは、Windows Forms のテキストコントロールに Microsoft Office スタイルのスペルチェック機能を提供します。このスキルでは、インストール、コントロールの関連付け、辞書の設定、コンテキストメニューとの統合、カスタマイズオプションについて説明します。

このスキルを使用する場合

次のような場合に、このスキルを使用してください。

• RichTextBox または TextBox コントロールにスペルチェックを追加する
• 辞書ソース（組み込みの英語辞書またはカスタム辞書）を設定する
• コンテキストメニューからスペルチェックを実行できるようにする
• 特殊な内容（メールアドレス、URL、数字）の無視ルールをカスタマイズする
• スペル候補や代替候補を取得する
• 異なる辞書形式を使用して複数の言語に対応する

ドキュメントの案内

はじめに

📄 参照: references/getting-started.md

• インストールとアセンブリ参照
• デザイナーまたはコードからコントロールを追加する
• SpellCheckerAdv をテキストコントロールとともに設定する
• スペルチェック操作を実行する
• 基本的な実装パターン

辞書の設定

📄 参照: references/dictionary-setup.md

• 既定の英語辞書を設定する
• 複数の言語に対応する Hunspell 辞書を追加する
• Ispell 辞書を追加する
• OpenOffice 辞書を追加する
• 実行時にカルチャを切り替える
• カスタム辞書のサポート

コンテキストメニューとの統合

📄 参照: references/context-menu-integration.md

• ISpellCheckerAdvEditorTools インターフェイスを実装する
• TextBoxSpellEditor ラッパークラスを作成する
• 実行時のコンテキストメニューを設定する
• ユーザー操作によるスペルチェックのワークフロー
• コンテキストメニューから辞書に追加する

カスタマイズと候補

📄 参照: references/customization-suggestions.md

• 無視オプション（メールアドレス、URL、大文字と小文字の混在、特殊記号）
• 候補リストを取得する
• 発音に基づく単語の代替候補
• アナグラムの候補
• カスタム単語の管理

クイックスタートの例

基本的なスペルチェックの設定:

using Syncfusion.Windows.Forms.Tools;

// 1. Create SpellCheckerAdv control
SpellCheckerAdv spellCheckerAdv = new SpellCheckerAdv();

// 2. Set dictionary path
spellCheckerAdv.DictionaryPath = "Syncfusion_en_us.dic";

// 3. Attach to RichTextBox and trigger spell check
RichTextBox richTextBox = new RichTextBox();
spellCheckerAdv.SpellCheck(new SpellCheckerAdvEditorWrapper(richTextBox));

コンテキストメニューでのスペルチェック:

// Implement ISpellCheckerAdvEditorTools
class TextBoxSpellEditor : ISpellCheckerAdvEditorTools
{
    private TextBoxBase textBox;
    
    public TextBoxSpellEditor(Control control)
    {
        Control = control;
    }
    
    public Control Control 
    { 
        get { return textBox; }
        set { textBox = value as TextBoxBase; }
    }
    
    public string Text
    {
        get { return textBox.Text; }
        set { textBox.Text = value; }
    }
    
    public string CurrentWord { get; set; }
    
    public void SelectText(int start, int length)
    {
        textBox.Select(start, length);
    }
}

// Enable context menu spell checking
TextBoxSpellEditor editor = new TextBoxSpellEditor(richTextBox);
spellCheckerAdv.PerformSpellCheckUsingContextMenu(editor);

よく使われる実装パターン

パターン 1: ダイアログベースのスペルチェック

ユーザーが「スペルチェック」ボタンをクリック → SpellCheckerAdv ダイアログが開く → ユーザーがスペルミスのある単語を確認して修正する → ダイアログが閉じる。

private void buttonSpellCheck_Click(object sender, EventArgs e)
{
    spellCheckerAdv.SpellCheck(new SpellCheckerAdvEditorWrapper(richTextBox));
}

パターン 2: リアルタイムのコンテキストメニュー

ユーザーがスペルミスのある単語を右クリック → 候補を含むコンテキストメニューが表示される → ユーザーが修正候補を選択するか、辞書に追加する。

TextBoxSpellEditor editor = new TextBoxSpellEditor(richTextBox);
spellCheckerAdv.PerformSpellCheckUsingContextMenu(editor);

パターン 3: 複数言語への対応

複数の辞書カルチャを設定し、ユーザーの設定またはコンテンツの言語に応じて実行時に切り替えます。

SpellCheckerAdv spellChecker = new SpellCheckerAdv();
spellChecker.Dictionaries = new DictionaryCollection();

// Add English dictionary
spellChecker.Dictionaries.Add(new HunspellDictionary()
{
    Culture = new CultureInfo("en-US"),
    DictionaryPath = @"en-US.dic",
    GrammarPath = @"en-US.aff"
});

// Add French dictionary
spellChecker.Dictionaries.Add(new HunspellDictionary()
{
    Culture = new CultureInfo("fr-FR"),
    DictionaryPath = @"fr-FR.dic",
    GrammarPath = @"fr-FR.aff"
});

// Switch to French at runtime
spellChecker.Culture = new CultureInfo("fr-FR");

主なプロパティとメソッド

要素	目的	使用する場面
DictionaryPath	組み込み辞書の場所を設定する	シンプルな英語のスペルチェック
Dictionaries	カスタム辞書（Hunspell、Ispell、OpenOffice）を追加する	複数言語への対応
Culture	アクティブなスペルチェック言語を設定する	言語の切り替え
SpellCheck()	スペルチェックダイアログを起動する	ユーザーが開始するスペルチェック
PerformSpellCheckUsingContextMenu()	コンテキストメニューの候補を有効にする	リアルタイムのスペルチェック
GetSuggestions()	修正候補を取得する	プログラムによるスペルチェック
IgnoreEmailAddress、IgnoreUrl など	特殊な内容の種類をスキップする	カスタマイズしたスペルチェック

よくあるユースケース

1. メールクライアント: カスタム辞書を使用した右クリックによるスペルチェック
2. ドキュメントエディター: コンテキストメニューを使った複数言語のスペルチェック
3. フォームの検証: 送信前にユーザー入力をチェックする
4. コンテンツ管理: コンテンツ内の URL とメールアドレスを無視する
5. 多言語アプリ: UI カルチャに応じてスペルチェック言語を切り替える