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

# TextLanguage オブジェクト（ITextLanguage インターフェイス）

> ABBYY FineReader Engine API の TextLanguage オブジェクト（ITextLanguage インターフェイス）— テキストの認識言語を表し、基本言語のコレクション、文字セット、およびその他のテキスト言語属性へのアクセスを提供する、ファイルまたはメモリに保存可能な永続オブジェクト。

このオブジェクトは、テキストの認識言語を表します。一般に、テキスト言語は、基本言語のセット、または単一の単語の言語です。テキストの基本言語のコレクションには、BaseLanguages プロパティを通じてアクセスできます。また、このオブジェクトでは、内部名や文字セットのグループなど、さまざまなテキスト言語属性にアクセスするためのメソッドを利用できます。

TextLanguage オブジェクトは永続オブジェクトです。つまり、オブジェクトの現在の状態を永続ストレージに書き込むことができます。後で、永続ストレージからオブジェクトの状態を読み取ることで、オブジェクトを再作成できます。オブジェクトの永続化には、次のメソッドが使用されます。

Linux: [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)、および [LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)、[LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)、[SaveToMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method)、および [LoadFromMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method)。

<div id="properties">
  ## プロパティ
</div>

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>名前</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>型</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>説明</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          <strong>Application</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/engine-object-iengine-interface">
              Engine
            </a>
          </strong>

          ,{" "}

          <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            読み取り専用
          </a>
        </p>
      </td>

      <td>
        <p>
          <strong>Engine</strong> オブジェクトを返します。
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>主要な属性</em>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="internalname" />

          <strong>InternalName</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              BSTR
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          テキスト言語の内部名を格納します。内部名は言語の識別に使用される場合があるため、一意であることが望まれます。
        </p>

        <p>
          <strong>TextLanguage</strong> 型の新しいオブジェクトが作成されると、このプロパティには空文字列が格納されます。他のテキスト言語と区別できるように、一意の値を割り当てることができます。
        </p>

        <p>既定では、このプロパティには空文字列が格納されます。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/language-related-objects/textlanguage/letterset-property">
              LetterSet
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              BSTR
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>テキスト言語に追加の文字セットを設定します。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="recognitionset" />

          <strong>RecognitionSet</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              BSTR
            </a>
          </strong>

          , 読み取り専用
        </p>
      </td>

      <td>
        <p>
          この <strong>TextLanguage</strong> で認識に使用される文字セット全体を返します。これは、そのベース言語のすべての文字セットと追加の文字セットを組み合わせたものです。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="baselanguages" />

          <strong>BaseLanguages</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/language-related-objects/baselanguages">
              BaseLanguages
            </a>
          </strong>

          ,{" "}

          <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            読み取り専用
          </a>
        </p>
      </td>

      <td>
        <p>
          現在のテキスト言語のベース言語コレクションへの参照を返します。このコレクションは常に存在しますが、既定では要素を含みません。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="prohibitingdictionaries" />

          <strong>ProhibitingDictionaries</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/language-related-objects/dictionarydescriptions">
              DictionaryDescriptions
            </a>
          </strong>

          ,{" "}

          <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            読み取り専用
          </a>
        </p>
      </td>

      <td>
        <p>
          禁止辞書のコレクションへの参照を返します。
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>追加の属性</em>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="impliedtextcategory" />

          <strong>ImpliedTextCategory</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/textcategoryenum">
              TextCategoryEnum
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          現在のテキスト言語の対象となるテキストのカテゴリを指定します。
        </p>

        <p>
          既定では、このプロパティには TC\_Unknown 値が設定されています。これは、このテキスト言語をあらゆる種類のテキストの認識に使用できることを意味します。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/language-related-objects/baselanguage/userproperty-property">
              UserProperty
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          <strong>VARIANT</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>TextLanguage </strong>型のオブジェクトに、任意のユーザー定義情報を関連付けることができます。
        </p>
      </td>
    </tr>
  </tbody>
</table>

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

| 名前                                                                                                                                               | 説明                                          |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------- |
| [CopyFrom](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method)                         | 現在のオブジェクトのプロパティを、別のオブジェクトの同じプロパティの値で初期化します。 |
| [LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                                       | オブジェクトの内容をディスク上のファイルから復元します。                |
| [LoadFromMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method) <br /><br /> **注:** *Windows のみ。* | オブジェクトの内容をグローバル メモリから復元します。                 |
| [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                                           | オブジェクトの内容をディスク上のファイルに保存します。                 |
| [SaveToMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) <br /><br /> **注:** *Windows のみ。*     | オブジェクトの内容をグローバル メモリに保存します。                  |

<div id="related-objects">
  ## 関連オブジェクト
</div>

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/textlanguage.gif?s=4cfb63b50e344c6119758a2cbe179b90" alt="TextLanguage" width="275" height="293" data-path="images/fine-reader/engine/textlanguage.gif" />[](/ja/fine-reader/engine/api-reference/language-related-objects/predefinedlanguage#textlanguage)[](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams#textlanguage)[](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams)[](/ja/fine-reader/engine/api-reference/language-related-objects/predefinedlanguage)[](/ja/fine-reader/engine/api-reference/language-related-objects/externaldictionarydescription)[](/ja/fine-reader/engine/api-reference/language-related-objects/regexpdictionarydescription)[](/ja/fine-reader/engine/api-reference/language-related-objects/userdictionarydescription)[](/ja/fine-reader/engine/api-reference/language-related-objects/standarddictionarydescription)[](/ja/fine-reader/engine/api-reference/language-related-objects/dictionarydescription)[](/ja/fine-reader/engine/api-reference/language-related-objects/dictionarydescriptions)[](/ja/fine-reader/engine/api-reference/language-related-objects/dictionarydescriptions)[](/ja/fine-reader/engine/api-reference/language-related-objects/baselanguage)[](/ja/fine-reader/engine/api-reference/language-related-objects/baselanguages)

[オブジェクト図](/ja/fine-reader/engine/api-reference/object-diagram)

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

このオブジェクトは、[LanguageDatabase](/ja/fine-reader/engine/api-reference/language-related-objects/languagedatabase) オブジェクトの [CreateTextLanguage](/ja/fine-reader/engine/api-reference/language-related-objects/languagedatabase/createtextlanguage-method) メソッドおよび [CreateCompoundTextLanguage](/ja/fine-reader/engine/api-reference/language-related-objects/languagedatabase/createcompoundtextlanguage-method) メソッドの出力パラメーターです。

<div id="samples">
  ## サンプル
</div>

<Accordion title="C# コード">
  ```csharp theme={null}
  FREngine.IEngine engine;
  // 新しい TextLanguage オブジェクトを作成
  FREngine.ILanguageDatabase languageDatabase = Engine.CreateLanguageDatabase();
  FREngine.ITextLanguage textLanguage = languageDatabase.CreateTextLanguage();
  // あらかじめ定義されている英語の言語設定から、すべての属性をコピー
  FREngine.ITextLanguage englishLanguage = Engine.PredefinedLanguages.Find( "English" ).TextLanguage;
  textLanguage.CopyFrom( englishLanguage );
  textLanguage.InternalName = "SampleTextLanguage";
  // 一部の属性を変更し、言語に辞書を関連付ける
  ...
  // 認識にこの言語を使用
  FREngine.IDocumentProcessingParams documentProcessingParams = Engine.CreateDocumentProcessingParams();
  documentProcessingParams.PageProcessingParams.RecognizerParams.TextLanguage = textLanguage;
  document.Process( documentProcessingParams );
  ```
</Accordion>

このオブジェクトは、以下のコードサンプルで使用されています。

* Linux: [CustomLanguage](/ja/fine-reader/engine/guided-tour/samples#customlanguage)
* Windows: [CommandLineInterface](/ja/fine-reader/engine/guided-tour/samples#commandlineinterface)、およびデモツール: [BatchProcessingRecognition](/ja/fine-reader/engine/guided-tour/samples#batchprocessingrecognition), [MultiProcessingRecognition](/ja/fine-reader/engine/guided-tour/samples#multiprocessingrecognition), [PDFExportProfiles](/ja/fine-reader/engine/guided-tour/samples#pdfexportprofiles)

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

[言語の取り扱い](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-languages)

[プロパティの取り扱い](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)