> ## 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 BaseLanguage (interface IBaseLanguage)

> Objet BaseLanguage (interface IBaseLanguage) dans l&#39;API ABBYY FineReader Engine — représente une langue de reconnaissance de base et donne accès à son nom interne, à ses jeux de lettres, à ses types de dictionnaire et à d&#39;autres attributs de la langue de base ; il s&#39;agit d&#39;un objet persistant qui peut être enregistré dans un fichier ou en mémoire, puis chargé depuis ceux-ci.

Cet objet représente une langue de reconnaissance de base. L'objet [TextLanguage](/fr/fine-reader/engine/api-reference/language-related-objects/textlanguage) — une langue de reconnaissance pour un texte — contient une collection de langues de base. Par exemple, l'anglais ou le français peuvent être représentés par des langues de base. Cet objet donne accès aux attributs d'une langue de base et permet d'obtenir et de définir son nom interne, ses jeux de lettres, son type de dictionnaire, etc.

L'objet BaseLanguage est un objet persistant. Cela signifie que l'état actuel de l'objet peut être enregistré dans un stockage persistant. Par la suite, l'objet peut être recréé en lisant son état depuis ce stockage persistant. Les méthodes suivantes assurent la persistance de l'objet :

Linux : [SaveToFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), et [LoadFromFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows : [SaveToFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), [LoadFromFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method), [SaveToMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method), et [LoadFromMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method).

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

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>Name</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>
          Returns the <strong>Engine</strong> object.
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>Main attributes</em>
        </p>
      </td>
    </tr>

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

          <strong>LanguageId</strong>
        </p>
      </td>

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

      <td>
        <p>
          Defines the ID of the language. To convert it to Win32 LCID use the{" "}

          <strong>
            <a href="/fr/fine-reader/engine/api-reference/engine-object-iengine-interface/supplementary-methods/convertlanguageidtolcid-method">
              IEngine::ConvertLanguageIdToLCID
            </a>
          </strong>

          {" "}

          method.
        </p>

        <p>
          By default, this property is initialized with the system default
          language ID.
        </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>
        </p>
      </td>

      <td>
        <p>
          Specifies the internal name of the base language. This name appears as
          an attribute of a character in the recognized text, so it is
          recommended that it were unique.
        </p>

        <p>The property is an empty string by default.</p>
      </td>
    </tr>

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

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

      <td>
        <p>Provides access to the specified letter set of the base language.</p>
      </td>
    </tr>

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

          <strong>DictionaryDescriptions</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/language-related-objects/dictionarydescriptions">
              DictionaryDescriptions
            </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>Returns a reference to the dictionary collection.</p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>Additional attributes</em>
        </p>
      </td>
    </tr>

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

          <strong>IsNaturalLanguage</strong>
        </p>
      </td>

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

      <td>
        <p>
          Indique si cette langue de base est une langue naturelle. Les langues naturelles sont conçues pour reconnaître des textes courants. Les langues formelles ne sont pas des langues naturelles.
        </p>

        <Note>
          Si cette propriété est TRUE, ABBYY FineReader Engine utilise des informations supplémentaires sur les langues lors de la reconnaissance (par exemple, il peut supposer que la langue peut inclure non seulement des caractères alphabétiques, mais également d'autres constructions telles que des numéros de téléphone ou des URL). Si la propriété est FALSE, ABBYY FineReader Engine utilise uniquement les attributs spécifiés dans les propriétés de la langue ; aucune autre information n'est utilisée.
        </Note>

        <p>Par défaut, la valeur de cette propriété est FALSE.</p>
      </td>
    </tr>

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

          <strong>AllowWordsFromDictionaryOnly</strong>
        </p>
      </td>

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

      <td>
        <p>
          Specifies if only the dictionary words are allowed during recognition
          in this base language. If this property is TRUE, a word that is not
          found in the dictionary of the base language can appear in the
          recognized text only if ABBYY FineReader Engine found no dictionary
          variants. If no dictionary is associated with the base language, the
          language will not be used for recognition.
        </p>

        <p>By default, the value of this property is FALSE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>
            <a href="/fr/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>
          Allows you to associate some user-defined information of any type with
          the <strong>BaseLanguage </strong>object.
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="methods">
  ## Méthodes
</div>

| Nom                                                                                                                                                              | Description                                                                                                   |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| [CopyFrom](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method)                                         | Initialise les propriétés de l'objet actuel avec les valeurs des propriétés correspondantes d'un autre objet. |
| [LoadFromFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                                                       | Restaure le contenu de l'objet à partir d'un fichier sur le disque.                                           |
| [LoadFromMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method) <br /><br /> **Remarque :** *Windows uniquement.* | Restaure le contenu de l'objet à partir de la mémoire globale.                                                |
| [SaveToFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                                                           | Enregistre le contenu de l'objet dans un fichier sur le disque.                                               |
| [SaveToMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) <br /><br /> **Remarque :** *Windows uniquement.*     | Enregistre le contenu de l'objet dans la mémoire globale.                                                     |

<div id="related-objects">
  ## Objets liés
</div>

<img src="https://mintcdn.com/abbyy/6udH-pkk8zkVafYH/images/fine-reader/engine/baselanguage.gif?s=c2acab4fc786a6b6c2f35de3fba11b61" alt="BaseLanguage" width="157" height="121" data-path="images/fine-reader/engine/baselanguage.gif" />[](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/element-property)[](/fr/fine-reader/engine/api-reference/language-related-objects/dictionarydescriptions)[](/fr/fine-reader/engine/api-reference/language-related-objects/baselanguages)[](/fr/fine-reader/engine/api-reference/language-related-objects/textlanguage)

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

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

Cet objet constitue le paramètre de sortie des méthodes [Item](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/item-method) et [AddNew](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/addnew-method) de l’objet [BaseLanguages](/fr/fine-reader/engine/api-reference/language-related-objects/baselanguages).

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

<Accordion title="Code C#">
  ```csharp theme={null}
  // Nous supposons qu'un nouvel objet TextLanguage a été créé
  // et que tous ses attributs ont été copiés à partir d'une langue prédéfinie
  // Obtenez le premier objet BaseLanguage dans TextLanguage
  BaseLanguage baseLanguage = textLanguage.BaseLanguages[0];
  // Remplacez le nom interne de la langue par un nom défini par l'utilisateur
  baseLanguage.InternalName = "SampleBaseLanguage";
  // Définissez un dictionnaire utilisateur pour la langue de base
  IDictionaryDescriptions dictionaryDescriptions = baseLanguage.DictionaryDescriptions;
  dictionaryDescriptions.DeleteAll();
  IDictionaryDescription dictionaryDescription = dictionaryDescriptions.AddNew( DictionaryTypeEnum.DT_UserDictionary );
  IUserDictionaryDescription userDictionaryDescription = dictionaryDescription.GetAsUserDictionaryDescription();
  userDictionaryDescription.FileName = "D:\\SampleDictionary.amd";
  // Utilisez la langue du texte pour la reconnaissance
  ...
  ```
</Accordion>

L'objet est utilisé dans les exemples de code suivants pour Linux et Windows : [CustomLanguage](/fr/fine-reader/engine/guided-tour/samples#customlanguage).

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

[BaseLanguages](/fr/fine-reader/engine/api-reference/language-related-objects/baselanguages)

[Travailler avec les langues](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-languages)

[Travailler avec les dictionnaires](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-dictionaries)

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