メインコンテンツへスキップ
Visual Components は Windows 用 FRE に実装されています。
TextValidator オブジェクトは ActiveX コントロールで、文書内で認識が不確かな文字を確認できます。文書は FRDocument プロパティを介してこのコンポーネントに接続されます。 Text Validator コンポーネントは次のように表示されます。 TextValidator 縦書きテキストの場合:
TextValidator_CJK
スペルチェックを開始するには、TextValidator オブジェクトの Spell または SpellBlock メソッドを呼び出します。すでにスペルチェックが実行中の場合は、先に停止する必要があります。停止しないと、これらのメソッドの新しい呼び出しは無視されます。
  • Text Editor の Check Spelling ボタンを使ってスペルチェックを開始することもできます。
  • 複雑な文字体系の言語 (中国語、タイ語、アルメニア語など) の一部の文字は、Text Validator で使用されているフォントに対応する文字が含まれていない場合、Text Validator に表示されないことがあります。この場合は、Options ダイアログで別のフォントを指定できます (Text Validator で Settings > Options をクリックし、View タブに移動して、Font used to display plain text ドロップダウン リストでフォントを選択します) 。
スペルチェックに関する情報は、専用の出力インターフェイスを通じて通知されます。これらのインターフェイスは、ITextValidatorEvents (C++ 用) および dispinterface DITextValidatorEvents (Visual Basic 用) です。 Visual Basic ユーザーは、イベント インターフェイスの実装の詳細を気にする必要はありません。この開発プラットフォームには、イベントを簡単に処理するための機能が用意されています。このオブジェクトは、Visual Basic で WithEvents として宣言できます。 C++ ユーザーにとってこれは、IConnectionPointContainer インターフェイスをサポートしていることを意味します。通知イベントを受け取るには、ITextValidatorEvents インターフェイスから派生したオブジェクトを作成し、標準の COM の手段を使って、そのオブジェクトと TextValidator オブジェクトに実装されているイベント ソースとの接続を設定する必要があります。 Text Validator コンポーネントは Component Synchronizer コンポーネントに接続できます。この場合、Text Validator のすべてのイベントは Synchronizer に接続されている他のコンポーネントに自動的に送信され、アプリケーション全体が同期して動作します。

プロパティ

,読み取り専用

スペルチェック中にユーザーが辞書に追加した単語のコレクションを表します。

スペルチェック中に辞書に単語が追加された場合、ユーザー辞書はILanguageDatabase::DictionaryExtensionsPathプロパティで指定されたフォルダに作成されます。

単語ペアのコレクションを表します。ペアの最初の単語はスペルチェック中に自動的に置換される元の単語で、2番目は置換後の単語です。

Text Validator がスペルチェック中にスペースを修正するかどうかを指定します。このプロパティの値を TRUE に設定すると、Text Validator は句読点の前後にあるスペースを修正します。

既定では、値は FALSE です。

スペルチェック中に無視される単語のコレクションを表します。

, 読み取り専用

スペルチェックが進行中かどうかを指定します。

Text Validator に接続されたドキュメントを表します。

Text Validator がロックされているかどうかを指定します。

このプロパティは、次の状況で役立ちます:

  • FineReader Engine API (Visual Components からではない) から解析、認識、合成、またはエクスポート操作が呼び出される場合、または
  • アプリケーションが特定のイベント (例:オブジェクトから) の通知を受け取り、これらのイベントハンドラーで Visual Components からの Windows メッセージを処理する場合。

この場合、解析、認識、合成、またはエクスポートの前にこのプロパティを TRUE に設定し、オペレーション終了後に FALSE に設定することを推奨します。この場合、Text Validator 経由でドキュメントが変更されるのを防げます。

既定では、値は FALSE です。

単語ペアのコレクションを表します。ペアの最初の単語はスペルチェック中に置換される元の単語で、2番目は置換後の単語です。

Text Validator の設定ファイルを含むフォルダのパスを指定します。他の Visual Components も同じプロパティを持ちます。各 Visual Component は独自の設定フォルダを使用します。

このプロパティの値は、ABBYY FineReader Engine がユーザー固有のデータを格納するフォルダのパスと、そのサブフォルダの名前から構成されます。既定では、ユーザー固有のデータのフォルダはFineReader Engine データフォルダです。FineReader Engine の初期化中に変更できます (関数、またはメソッド経由で)。サブフォルダーのデフォルト名は任意の GUID です。サブフォルダーの名前を変更するには、設計時に Visual Studio でコンポーネントのプロパティに新しい名前を指定します。ランタイムでプロパティの値を指定しようとしても、この値は無視されます。

設計時に Visual Studio のフォームにコンポーネントを追加した場合、プロパティの値はデフォルト値で自動的に定義されるか、カスタム値で手動で定義されます。いずれの場合も、値は設計時に定義されます。何らかの理由でプロパティの値が設計時に定義されていない場合 (例: ランタイムでコンポーネントを動的に生成する場合) 、コンポーネントが初期化されるたびに設定を含む新しいフォルダーを作成します。フォルダーの増加を避けるため、コンポーネントの初期化解除後に作成された設定フォルダーを削除する必要があります。この場合、コンポーネントのデフォルト設定のみを使用でき、セッション間で設定を保存することはできません。

スペルチェック中に複合語で Text Validator が停止するかどうかを指定します。

デフォルトでは、値は FALSE です。

スペルチェック中にガーベッジで Text Validator が停止するかどうかを指定します。ガーベッジとは意味のない文字の組み合わせです。

デフォルトでは、値は FALSE です。

スペルチェック中に辞書に存在しない単語で Text Validator が停止するかどうかを指定します。このプロパティと StopAtUncertain プロパティを同時に FALSE に設定することはできません。

デフォルトでは、値は TRUE です。

スペルチェック中に不確実に認識された文字で Text Validator が停止するかどうかを指定します。このプロパティと StopAtNonDictionary プロパティを同時に FALSE に設定することはできません。

デフォルトでは、値は TRUE です。

,読み取り専用

スペルチェック中に不確実に認識された単語のスペル修正のために提案された単語のコレクションを表します。

ドキュメントのデフォルト合成パラメータを指定します。Text Validator がドキュメント合成を実行する必要がある場合にこれらのパラメータが使用されます (編集操作によりドキュメントの論理構造が正しくなくなる場合に発生する可能性があります) 。

Text Validator が Component Synchronizer に接続されている場合、ドキュメント合成に使用されるパラメータを変更するにはIComponentSynchronizer::ProcessingParamsプロパティを使用します。Text Validator のプロパティ経由でこれらのパラメータを変更すると、エラーが発生する可能性があります。

,読み取り専用

不確実な文字または不確実な単語の位置を表します。

、読み取り専用

クライアント領域のウィンドウ ハンドルを返します。

メソッド

名前説明
EndSpellingスペルチェックを停止します。
Spell指定した位置からスペルチェックを開始します。
SpellBlock指定したブロックのスペルチェックを行います。
UpdateOptionsText Validator の Options ダイアログで指定した設定を更新します。別の Visual Component でオプションが変更された場合は、オプションを現在の状態に更新するために、このメソッドを呼び出す必要があることがあります。

サンプル

このコンポーネントは、以下のコードサンプルで使用されています:VisualComponents

関連項目

ITextValidatorEvents IComponentSynchronizer::TextValidator グラフィカル ユーザー インターフェイスを備えたアプリケーションの作成