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

# Objet PredefinedLanguage (Interface IPredefinedLanguage)

> Objet PredefinedLanguage (interface IPredefinedLanguage) dans l’API ABBYY FineReader Engine — Représente une seule langue de reconnaissance prédéfinie ; expose ExternalName, InternalName, LanguageCategory et le TextLanguage correspondant en lecture seule.

Cet objet représente une langue prédéfinie unique issue d'une collection de [langues prédéfinies d'ABBYY FineReader Engine](/fr/fine-reader/engine/specifications/predefined-languages). Les langues prédéfinies sont des langues prises en charge par défaut. Cet objet contient des propriétés reflétant les attributs de la langue prédéfinie, tels que son nom externe, ses composants et sa catégorie. La propriété TextLanguage contient la langue de texte correspondante.

<div id="properties">
  ## Propriétés
</div>

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>Nom</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Type</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Description</strong>
        </p>
      </th>
    </tr>
  </thead>

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

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

          ,{" "}

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

      <td>
        <p>
          Renvoie l'objet <strong>Engine</strong>.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>ExternalName</strong>
        </p>
      </td>

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

          , lecture seule
        </p>
      </td>

      <td>
        <p>
          Stocke le nom externe de la langue prédéfinie. Ce nom est localisé et peut être utilisé dans l'interface utilisateur. La valeur de cette propriété dépend de la langue des messages actuellement définie (

          <strong>
            <a href="/fr/fine-reader/engine/api-reference/engine-object-iengine-interface">
              IEngine::MessagesLanguage
            </a>
          </strong>

          {" "}

          propriété). Par exemple, si la langue des messages est l'anglais, le nom de la langue prédéfinie correspondant au français sera "French". Si la langue des messages est le français, le nom de cette même langue prédéfinie sera "Français".
        </p>
      </td>
    </tr>

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

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

          , lecture seule
        </p>
      </td>

      <td>
        <p>
          Stocke le nom interne de la langue prédéfinie. C'est ce nom qui doit être passé à la méthode{" "}

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

          {" "}

          . Pour obtenir la liste des noms internes disponibles des langues prédéfinies, voir{" "}

          <a href="/fr/fine-reader/engine/specifications/predefined-languages">
            Liste des langues prédéfinies d'ABBYY FineReader Engine
          </a>

          .
        </p>
      </td>
    </tr>

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

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

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

          , lecture seule
        </p>
      </td>

      <td>
        <p>
          Indique la catégorie à laquelle appartient la langue prédéfinie actuelle. Vous pouvez utiliser cette propriété pour organiser les langues dans votre interface utilisateur.
        </p>
      </td>
    </tr>

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

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

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

          ,{" "}

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

      <td>
        <p>
          Donne accès à l'objet{" "}

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

            {" "}
          </strong>

          correspondant à la langue prédéfinie actuelle. L'objet <strong>TextLanguage </strong>renvoyé par cette propriété est en lecture seule (ses méthodes de modification renvoient E\_FAIL). Pour créer une langue de texte modifiable correspondant à une langue de reconnaissance prédéfinie, procédez comme suit :
        </p>

        <ol>
          <li value="1">
            Créez un objet{" "}

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

              {" "}
            </strong>

            vide.
          </li>

          <li value="2">
            Appelez sa méthode{" "}

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

            {" "}

            en lui passant un pointeur vers l'interface d'un objet <strong>TextLanguage </strong>
            prédéfini comme paramètre d'entrée. Un pointeur vers l'interface d'un objet de langue de texte prédéfini peut être obtenu à partir de cette propriété.
          </li>
        </ol>

        <p>
          Vous pouvez utiliser cette propriété pour initialiser la propriété{" "}

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

          {" "}

          avec la valeur correspondant à la langue prédéfinie. Une autre approche consiste à appeler la méthode{" "}

          <strong>
            <a href="/fr/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">
  ## Objets associés
</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" />[](/fr/fine-reader/engine/api-reference/language-related-objects/textlanguage)[](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/element-property)[](/fr/fine-reader/engine/api-reference/language-related-objects/predefinedlanguages)

[Diagramme d'objets](/fr/fine-reader/engine/api-reference/object-diagram)

<div id="output-parameter">
  ## Paramètre de sortie
</div>

Cet objet est le paramètre de sortie des méthodes [Item](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/item-method) et [Find](/fr/fine-reader/engine/api-reference/language-related-objects/predefinedlanguages/find-method) de l'objet [PredefinedLanguages](/fr/fine-reader/engine/api-reference/language-related-objects/predefinedlanguages).

<div id="samples">
  ## Exemples
</div>

<Accordion title="Code C#">
  ```csharp theme={null}
  FREngine.IEngine engine;
  // Créer un nouvel objet TextLanguage comme copie de la langue anglaise prédéfinie
  ILanguageDatabase languageDatabase = Engine.CreateLanguageDatabase();
  ITextLanguage textLanguage = languageDatabase.CreateTextLanguage();
  // Copier tous les attributs de la langue anglaise prédéfinie
  ITextLanguage englishLanguage = Engine.PredefinedLanguages.Find( "English" )
   .TextLanguage;
  textLanguage.CopyFrom( englishLanguage );
  textLanguage.InternalName = "SampleTextLanguage";
  ```
</Accordion>

L'objet est utilisé dans les exemples de code suivants :

* Linux : [CustomLanguage](/fr/fine-reader/engine/guided-tour/samples#customlanguage)
* Windows : [CustomLanguage](/fr/fine-reader/engine/guided-tour/samples#customlanguage) ; et outils de démonstration : [BatchProcessingRecognition](/fr/fine-reader/engine/guided-tour/samples#batchprocessingrecognition), [Engine Predefined Processing Profiles](/fr/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles), [MultiProcessingRecognition](/fr/fine-reader/engine/guided-tour/samples#multiprocessingrecognition), [PDFExportProfiles](/fr/fine-reader/engine/guided-tour/samples#pdfexportprofiles)

<div id="see-also">
  ## Voir aussi
</div>

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

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

[Liste des langues prédéfinies d'ABBYY FineReader Engine](/fr/fine-reader/engine/specifications/predefined-languages)

[Utilisation des langues](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-languages)

[Utilisation des propriétés](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)