> ## 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.

# IExternalDictionary インターフェイス

> ABBYY FineReader Engine API の IExternalDictionary インターフェイス — 標準辞書、ユーザー辞書、正規表現辞書に加えて、カスタム辞書型を実装するためのクライアント側インターフェイスです。IUnknown から派生しています。

これは[外部辞書](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-dictionaries#external)のインターフェイスです。このインターフェイスとそのすべてのメソッドはクライアント側で実装されます。IUnknown インターフェイスから派生しているため、クライアントオブジェクトは IUnknown のメソッドも実装する必要があります。

ABBYY FineReader Engine のオブジェクトでは、[辞書の型](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-dictionaries#types)として標準辞書、ユーザー辞書、正規表現ベースの辞書を使用できます。これらの辞書の型が要件に合わない場合は、IExternalDictionary インターフェイスを使用して独自の辞書型を実装できます。作成した辞書は、[ExternalDictionaryDescription](/ja/fine-reader/engine/api-reference/language-related-objects/externaldictionarydescription) オブジェクトの [SetDictionary](/ja/fine-reader/engine/api-reference/language-related-objects/externaldictionarydescription/setdictionary-method) メソッドを使用してアタッチできます。詳細については、[辞書の使用方法](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-dictionaries)のセクションを参照してください。

<div id="guidelines-for-external-dictionary-creation">
  ## 外部辞書作成のガイドライン
</div>

ABBYY FineReader Engine はテキスト内の単語を認識し、その単語内の各文字の認識候補とともに外部辞書に渡します。辞書は、利用可能なすべての組み合わせの中から辞書に含まれる組み合わせを選択し、[IExternalDictionaryCallback](/ja/fine-reader/engine/api-reference/language-related-objects/externaldictionarycallback) コールバック インターフェイスを介してそれらを返す必要があります。各文字の認識候補には、ABBYY FineReader Engine が単語内の各位置に現れると想定する、考えられるすべての候補が含まれていることに注意してください。

* 文字の大文字・小文字:
  * ABBYY FineReader Engine が 1 文字に対して提供する候補に大文字と小文字の両方が含まれている場合、辞書は大文字の単語と小文字の単語の両方を確認し、見つかった場合は両方の候補を返す必要があります。
  * 1 文字の候補に小文字のみが含まれている場合、辞書は小文字の単語のみを返す必要があります。
  * 1 文字の候補に小文字のみが含まれていて、辞書には大文字の単語しか含まれていない場合、辞書がこの組み合わせを受け入れるかどうかは任意です。
  * 一般に、単語には次のつづりのバリエーションがあります。単語内のすべての文字が小文字、最初の文字のみが大文字でそれ以外は小文字、単語内のすべての文字が大文字です。したがって、通常の単語については、辞書にはこれらのバリエーションのみを含めることをお勧めします。
* ダイアクリティカル マーク:
  * その言語でダイアクリティカル マークありとなしの両方の表記が許可されている場合、辞書は両方の表記を確認できる必要があります。
  * その言語で 1 つの表記バリエーションのみが許可されている場合、辞書はそのバリエーションのみを確認する必要があります。
* 文字セット:
  * 辞書に渡される文字認識候補には、ABBYY FineReader Engine がその言語で許容可能と判断した文字のみが含まれます。ある文字が辞書にとって「不明」である場合、辞書はその文字を任意の文字に置き換えてかまいません。言語のアルファベットで許容されない文字を含む単語は、ABBYY FineReader Engine によって無視されます。
* ハイフン:
  * ABBYY FineReader Engine は、単語を辞書に渡す前にハイフンを削除します。したがって、渡された候補にハイフンが現れる場合、それは ABBYY FineReader Engine が確認しようとしているハイフン付きの単語です。
  * ABBYY FineReader Engine は単語全体を辞書に渡します。単語がハイフンなしで次の行にまたがっている場合、ABBYY FineReader は 2 つの部分を結合し、その結合結果を辞書で確認しようとします。
* 重み:
  * 単語の標準の重みは 100 です。

<div id="methods">
  ## メソッド
</div>

| 名前                                                                                                                            | 説明                                                                                                                                                                                                                                                                                                                                 |
| ----------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [CheckPrefix](/ja/fine-reader/engine/api-reference/language-related-objects/iexternaldictionary-interface/checkprefix-method) | 指定されたプレフィックスを持つ単語が辞書に含まれているかどうかを判定します。                                                                                                                                                                                                                                                                                             |
| [CheckWords](/ja/fine-reader/engine/api-reference/language-related-objects/iexternaldictionary-interface/checkwords-method)   | [ExternalDictionaryCallback](/ja/fine-reader/engine/api-reference/language-related-objects/externaldictionarycallback) オブジェクトの [ExternalDictionaryResult](/ja/fine-reader/engine/api-reference/language-related-objects/externaldictionarycallback/externaldictionaryresult-method) メソッドを使用して、辞書語を含むコレクション内の文字列に関する情報を認識エンジンに渡します。 |

<div id="input-parameter">
  ## 入力パラメーター
</div>

ExternalDictionaryオブジェクトは、[IExternalDictionaryDescription::SetDictionary](/ja/fine-reader/engine/api-reference/language-related-objects/externaldictionarydescription/setdictionary-method)メソッドの入力パラメーターです。

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

Linuxでは、Engineオブジェクトがアウトプロセスサーバーとしてロードされている場合、このインターフェイスは機能しません。

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

[IExternalDictionaryCallback](/ja/fine-reader/engine/api-reference/language-related-objects/externaldictionarycallback)

[ExternalDictionaryDescription](/ja/fine-reader/engine/api-reference/language-related-objects/externaldictionarydescription)

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