> ## 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 Object の AddWordsToCacheDictionary メソッド

> ABBYY FineReader Engine API の FRPage Object における AddWordsToCacheDictionary メソッド。ページレベルの cache dictionary に複数の単語を追加します。IEngine.AutoCleanRecognizerSession は FALSE に設定する必要があります。

このメソッドは、複数の単語を cache dictionary に追加します。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 AddWordsToCacheDictionary(
  IRecognizerParams*  params,
  IStringsCollection* Words,
  IIntsCollection*    Weights
);
```

### C\#

```csharp theme={null}
void AddWordsToCacheDictionary(
  IRecognizerParams  params,
  IStringsCollection Words,
  IIntsCollection    Weights
);
```

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

```vb theme={null}
Sub AddWordsToCacheDictionary( _
  params As IRecognizerParams, _
  Words As IStringsCollection, _
  [Weights As IIntsCollection = Nothing] _
)
```

<div id="parameters">
  ## パラメーター
</div>

params

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

Words

\[in] [StringsCollection](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/stringscollection) 型のこのパラメーターには、新たに追加された単語のコレクションが含まれます。

Weights

\[in] [IntsCollection](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/intscollection) 型のこのパラメーターは、単語のコレクションと同じサイズである必要があり、新たに追加された単語の重み情報を渡すために使用されます。単語の重みは 1 ～ 100 の範囲でなければなりません。このパラメーターには 0 を渡すこともでき、その場合はすべての単語がデフォルトの重み 100 で辞書に含まれます。辞書内で単語に割り当てられる重みには、離散的な値のセットしか使用できません。このパラメーターで渡された値は、その離散値セットのうち最も近い値に丸められます。

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

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

<div id="remarks">
  ## 注記
</div>

* より効率的に処理するため、追加する単語はあらかじめアルファベット順に並べ替えておくことをお勧めします。
* 1 つの単語を cache dictionary に追加するには、[AddWordToCacheDictionary](/ja/fine-reader/engine/api-reference/document-related-objects/frpage/addwordtocachedictionary-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)