FRPage オブジェクトの AddWordToCacheDictionary メソッド

このメソッドは、cache dictionary に単語を1つ追加します。cache dictionary は小規模な辞書 (約100単語) で、処理中に容易に変更できます。処理中にドキュメントに関する新しい情報が判明した場合など、より精密に辞書を選択できる状況で cache dictionary を活用できます。

追加しようとしている単語がすでに辞書に存在する場合、重複は作成されませんが、その単語の重みは、辞書で指定された重みとこのメソッドの呼び出しで渡した重みのうち、大きい方の値になります。

cache dictionary を使用するには、IEngine::AutoCleanRecognizerSession プロパティを FALSE に設定する必要があります。AutoCleanRecognizerSession プロパティはデフォルトで TRUE に設定されており、FineReader Engine は各ページの認識後に認識セッションをクリーンアップします。この場合、cache dictionary もクリーンアップされます。ユーザーデータの意図しない消失を防ぐため、FineReader Engine はこのモードでの cache dictionary の使用を禁止しています。cache dictionary を使用する場合、必要に応じて IEngine::CleanRecognizerSession メソッドを呼び出して認識セッションを手動でクリーンアップする責任はユーザー側にあります。認識セッションのクリーンアップが必要なタイミングについては、当該メソッドの説明を参照してください。

​

構文

​

C++

HRESULT AddWordToCacheDictionary(
  IRecognizerParams* params,
  BSTR               Word,
  int                Weight
);

​

C#

void AddWordToCacheDictionary(
  IRecognizerParams params,
  string           Word,
  int              Weight
);

​

Visual Basic .NET

Sub AddWordToCacheDictionary( _
  params As IRecognizerParams, _
  Word As String, _
  [Weight As Integer = 100] _
)

​

Parameters

params

[in] ページ処理のパラメータを格納する RecognizerParams オブジェクト。

Word

[in] このパラメータには、新しく追加された単語が含まれます。

Weight

[in] dictionaryにおいてその単語に割り当てられる重み。1〜100の範囲で指定する必要があります。単語の重みが高いほど、認識時にその単語がバリアントとして選択される可能性が高くなります。このパラメータの標準値は100で、デフォルトでもこの値が使用されます。dictionaryにおいて単語に割り当てられる重みは、離散値のセットのみを取ることができます。このパラメータに渡された値は、離散値セットの中で最も近い値に丸められます。

​

戻り値

このメソッドには固有の戻り値はありません。ABBYY FineReader Engine 関数の標準戻り値を返します。

​

備考

単語のグループをcache dictionaryに追加する場合は、AddWordsToCacheDictionaryメソッドを使用してください。

​

関連項目

FRPage

辞書の使用方法