> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> ABBYY FineReader Engine API における FRPage オブジェクトの AddWordToCacheDictionary メソッド。ページレベルの cache dictionary に単語を 1 つ追加します。IEngine.AutoCleanRecognizerSession は FALSE に設定する必要があります。

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

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

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

<div id="syntax">
  ## 構文
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT AddWordToCacheDictionary(
  IRecognizerParams* params,
  BSTR               Word,
  int                Weight
);
```

### C\#

```csharp theme={null}
void AddWordToCacheDictionary(
  IRecognizerParams params,
  string           Word,
  int              Weight
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Sub AddWordToCacheDictionary( _
  params As IRecognizerParams, _
  Word As String, _
  [Weight As Integer = 100] _
)
```

<div id="parameters">
  ## Parameters
</div>

params

\[in] ページ処理のパラメータを格納する [RecognizerParams](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams) オブジェクト。

Word

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

Weight

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

<div id="return-values">
  ## 戻り値
</div>

このメソッドには固有の戻り値はありません。[ABBYY FineReader Engine 関数の標準戻り値](/ja/fine-reader/engine/api-reference/return-codes)を返します。

<div id="remarks">
  ## 備考
</div>

単語のグループをcache dictionaryに追加する場合は、[AddWordsToCacheDictionary](/ja/fine-reader/engine/api-reference/document-related-objects/frpage/addwordstocachedictionary-method)メソッドを使用してください。

<div id="see-also">
  ## 関連項目
</div>

[FRPage](/ja/fine-reader/engine/api-reference/document-related-objects/frpage)

[辞書の使用方法](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-dictionaries)