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

# 事前定義言語オブジェクト（IPredefinedLanguage インターフェイス）

> ABBYY FineReader Engine API の PredefinedLanguage オブジェクト（IPredefinedLanguage インターフェイス）— 単一の事前定義認識言語を表し、ExternalName、InternalName、LanguageCategory、および対応する読み取り専用の TextLanguage を備えています。

このオブジェクトは、[ABBYY FineReader Engine の事前定義言語](/ja/fine-reader/engine/specifications/predefined-languages) のコレクション内の 1 つの事前定義言語を表します。事前定義言語とは、デフォルトでサポートされている言語です。このオブジェクトには、外部名、コンポーネント、カテゴリなど、事前定義言語の属性を表すプロパティが含まれています。TextLanguage プロパティには、対応するテキスト言語が含まれます。

<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">
            read-only
          </a>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <strong>ExternalName</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>
            <a href="/ja/fine-reader/engine/api-reference/engine-object-iengine-interface">
              IEngine::MessagesLanguage
            </a>
          </strong>

          {" "}

          プロパティ) によって決まります。たとえば、メッセージ言語が英語の場合、フランス語に対応する定義済み言語の名前は "French" になります。メッセージ言語がフランス語の場合、同じ定義済み言語の名前は "Français" になります。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <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>
          定義済み言語の内部名を格納します。この名前を{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/language-related-objects/predefinedlanguages/find-method">
              IPredefinedLanguages::Find
            </a>
          </strong>

          {" "}

          メソッドに渡す必要があります。使用可能な定義済み言語の内部名の一覧については、{" "}

          <a href="/ja/fine-reader/engine/specifications/predefined-languages">
            ABBYY FineReader Engine 定義済み言語の一覧
          </a>

          を参照してください。
        </p>
      </td>
    </tr>

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

          <strong>LanguageCategory</strong>
        </p>
      </td>

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

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

      <td>
        <p>
          現在の定義済み言語が属するカテゴリを示します。このプロパティを使用して、ユーザーインターフェイス上で言語を整理できます。
        </p>
      </td>
    </tr>

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

          <strong>TextLanguage</strong>
        </p>
      </td>

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

          ,{" "}

          <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            read-only
          </a>
        </p>
      </td>

      <td>
        <p>
          現在の定義済み言語に対応する{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/language-related-objects/textlanguage">
              TextLanguage
            </a>

            {" "}
          </strong>

          オブジェクトへのアクセスを提供します。このプロパティが返す <strong>TextLanguage </strong>オブジェクトは読み取り専用です (変更メソッドは E\_FAIL を返します) 。定義済み認識言語に対応する編集可能なテキスト言語を作成する必要がある場合は、次の 2 つの手順に従ってください。
        </p>

        <ol>
          <li value="1">
            空の{" "}

            <strong>
              <a href="/ja/fine-reader/engine/api-reference/language-related-objects/textlanguage">
                TextLanguage
              </a>

              {" "}
            </strong>

            オブジェクトを作成します。
          </li>

          <li value="2">
            定義済みの <strong>TextLanguage </strong>オブジェクトのインターフェイスへのポインターを入力パラメーターとして、その{" "}

            <strong>
              <a href="/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method">
                CopyFrom
              </a>
            </strong>

            {" "}

            メソッドを呼び出します。定義済みテキスト言語オブジェクトのインターフェイスへのポインターは、このプロパティから取得できます。
          </li>
        </ol>

        <p>
          このプロパティを使用して、定義済み言語に対応する値で{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams#textlanguage">
              IRecognizerParams::TextLanguage
            </a>
          </strong>

          {" "}

          プロパティを初期化することもできます。代替手段として、{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams/setpredefinedtextlanguage-method">
              IRecognizerParams::SetPredefinedTextLanguage
            </a>
          </strong>

          {" "}

          メソッドを呼び出す方法もあります。
        </p>
      </td>
    </tr>
  </tbody>
</table>

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

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/predefinedlanguage.gif?s=107956e7225e7551c47bb4b869a9dc8e" alt="PredefinedLanguage" width="154" height="92" data-path="images/fine-reader/engine/predefinedlanguage.gif" />[](/ja/fine-reader/engine/api-reference/language-related-objects/textlanguage)[](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/element-property)[](/ja/fine-reader/engine/api-reference/language-related-objects/predefinedlanguages)

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

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

このオブジェクトは、[PredefinedLanguages](/ja/fine-reader/engine/api-reference/language-related-objects/predefinedlanguages)オブジェクトの [Item](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/item-method) メソッドおよび [Find](/ja/fine-reader/engine/api-reference/language-related-objects/predefinedlanguages/find-method) メソッドの出力パラメーターです。

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

<Accordion title="C# コード">
  ```csharp theme={null}
  FREngine.IEngine engine;
  // 定義済みの英語言語をコピーして、新しい TextLanguage オブジェクトを作成します
  ILanguageDatabase languageDatabase = Engine.CreateLanguageDatabase();
  ITextLanguage textLanguage = languageDatabase.CreateTextLanguage();
  // 定義済みの英語言語からすべての属性をコピーします
  ITextLanguage englishLanguage = Engine.PredefinedLanguages.Find( "English" )
   .TextLanguage;
  textLanguage.CopyFrom( englishLanguage );
  textLanguage.InternalName = "SampleTextLanguage";
  ```
</Accordion>

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

* Linux: [CustomLanguage](/ja/fine-reader/engine/guided-tour/samples#customlanguage)
* Windows: [CustomLanguage](/ja/fine-reader/engine/guided-tour/samples#customlanguage); および Demo Tools: [BatchProcessingRecognition](/ja/fine-reader/engine/guided-tour/samples#batchprocessingrecognition), [Engine Predefined Processing Profiles](/ja/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles), [MultiProcessingRecognition](/ja/fine-reader/engine/guided-tour/samples#multiprocessingrecognition), [PDFExportProfiles](/ja/fine-reader/engine/guided-tour/samples#pdfexportprofiles)

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

[PredefinedLanguages](/ja/fine-reader/engine/api-reference/language-related-objects/predefinedlanguages)

[TextLanguage](/ja/fine-reader/engine/api-reference/language-related-objects/textlanguage)

[ABBYY FineReader Engine の事前定義言語一覧](/ja/fine-reader/engine/specifications/predefined-languages)

[言語の使用](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-languages)

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