> ## 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 Layout (interface ILayout)

> Objet Layout (interface ILayout) dans l’API ABBYY FineReader Engine — conteneur racine des blocs du layout d’une image ; expose les collections de blocs (Blocks, BlackSeparators, SortedBlocks, VisualBlocks), Width/Height, Name, TextAsString et PageRegion ; objet persistant pouvant être enregistré dans un fichier, en mémoire ou dans un flux.

Cet objet expose des méthodes et des propriétés permettant de travailler avec le Layout de l'image. L'objet Layout sert de racine aux blocs. Ses attributs sont la largeur et la hauteur. Ces paramètres prennent les mêmes valeurs que les paramètres correspondants de la page noir et blanc de l'image pour laquelle l'objet Layout est défini. Cette opération est effectuée automatiquement lorsque l'objet Layout est analysé ou reconnu.

L'objet Layout est un objet persistant. Cela signifie que l'état actuel de l'objet peut être écrit dans un stockage persistant. Par la suite, l'objet peut être recréé en relisant son état à partir du stockage persistant. Les méthodes suivantes assurent la persistance de l'objet :

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

<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>
          Retourne l'objet <strong>Engine</strong>.
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>Collections de blocs</em>
        </p>
      </td>
    </tr>

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

          <strong>BlackSeparators</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/layout-related-objects/layoutblocks">
              LayoutBlocks
            </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 à la collection de blocs Separator et de groupes de Separator du layout.
        </p>

        <p>
          Cette propriété fait référence à un objet valide, qu'il existe ou non des blocs Separator dans le <strong>Layout</strong>. En l'absence de Separator dans le <strong>Layout</strong>, la propriété{" "}
          <strong>BlackSeparators</strong> est vide.
        </p>
      </td>
    </tr>

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

          <strong>Blocks</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/layout-related-objects/layoutblocks">
              LayoutBlocks
            </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 à la collection de blocs du layout. Cette collection ne contient pas les blocs Separator ni les groupes de Separator. Pour accéder à ces blocs, utilisez la propriété{" "}
          <strong>BlackSeparators</strong>.
        </p>

        <p>
          Cette propriété fait référence à un objet valide, qu'il existe ou non des blocs dans le <strong>Layout</strong>. En l'absence de blocs dans le <strong>Layout</strong>, la propriété <strong>Blocks</strong>{" "}
          est vide. Voir aussi{" "}

          <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            Utilisation des propriétés d'objet en lecture seule
          </a>

          .
        </p>

        <Note>
          Cette collection ne contient jamais de blocs d'autoanalyse, car ce type de blocs est utilisé uniquement dans les composants visuels.
        </Note>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/layout-related-objects/layout/sortedblocks-property">
              SortedBlocks
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/layout-related-objects/layoutblocks">
              LayoutBlocks
            </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>
          Retourne la collection triée logiquement des blocs du layout.
        </p>

        <p>
          Cette collection contient les mêmes blocs que ceux retournés par la propriété{" "}
          <strong>Blocks</strong>. Ils sont triés selon la position du coin supérieur gauche de chaque bloc, d'abord de gauche à droite, puis de haut en bas. Les blocs proches les uns des autres sont considérés comme appartenant à un même groupe logique.
        </p>
      </td>
    </tr>

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

          <strong>VisualBlocks</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/layout-related-objects/layoutblocks">
              LayoutBlocks
            </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>
        <Warning>
          Les composants visuels ne sont actuellement pris en charge que sous Windows.
        </Warning>

        <p>
          Donne accès à la collection de blocs visibles dans les composants visuels. Cette collection peut contenir des blocs des types suivants : texte, tableau, image raster, Barcode, autoanalyse. L'ordre des blocs dans cette collection est identique à celui affiché dans les composants visuels.
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>Attributs supplémentaires</em>
        </p>
      </td>
    </tr>

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

          <strong>Height</strong>
        </p>
      </td>

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

          , read-only
        </p>
      </td>

      <td>
        <p>
          Retourne la hauteur du layout en pixels. Elle est égale à la hauteur de{" "}

          <strong>
            <a href="/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument">
              ImageDocument
            </a>
          </strong>

          {" "}

          du{" "}

          <strong>
            <a href="/fr/fine-reader/engine/api-reference/document-related-objects/frpage">
              FRPage
            </a>
          </strong>

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

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

          <strong>Name</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>Stocke le nom du layout.</p>
      </td>
    </tr>

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

          <strong>TextAsString</strong>
        </p>
      </td>

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

          , read-only
        </p>
      </td>

      <td>
        <p>
          Écrit le texte de tous les blocs de texte et de tableau sur une seule ligne. L'objet{" "}

          <strong>
            <a href="/fr/fine-reader/engine/api-reference/layout-related-objects/tablecells">
              TableCells
            </a>
          </strong>

          {" "}

          détermine l'ordre dans lequel le texte des cellules de tableau est écrit.
          Cet ordre peut donc ne pas correspondre à l'ordre des cellules de tableau tel qu'elles apparaissent dans
          l'image. Le texte des blocs Barcode n'est pas écrit.
        </p>
      </td>
    </tr>

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

          <strong>PageRegion</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region">
              Region
            </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>
          Stocke la Region englobante des blocs du layout. Si aucun bloc n'est présent,
          cette propriété retourne la Region vide.
        </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>
          Permet d'associer des informations définies par l'utilisateur à un objet de
          type <strong>Layout </strong>.
        </p>
      </td>
    </tr>

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

          <strong>Width</strong>
        </p>
      </td>

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

          , read-only
        </p>
      </td>

      <td>
        <p>
          Retourne la largeur du layout en pixels. Elle est égale à la largeur de{" "}

          <strong>
            <a href="/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument">
              ImageDocument
            </a>
          </strong>

          {" "}

          du{" "}

          <strong>
            <a href="/fr/fine-reader/engine/api-reference/document-related-objects/frpage">
              FRPage
            </a>
          </strong>

          {" "}

          correspondant.
        </p>
      </td>
    </tr>
  </tbody>
</table>

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

| Nom                                                                                                                      | Description                                                                                               |
| ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------- |
| [Clean](/fr/fine-reader/engine/api-reference/layout-related-objects/layout/clean-method)                                 | Supprime tous les types de blocs et de Separator du Layout.                                               |
| [CopyFrom](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method) | Initialise les propriétés de l'objet courant avec les valeurs des propriétés similaires d'un autre objet. |
| [LoadFromFile](/fr/fine-reader/engine/api-reference/layout-related-objects/layout/loadfromfile-method)                   | Restaure le contenu de l'objet à partir d'un fichier sur le disque.                                       |
| [LoadFromMemory](/fr/fine-reader/engine/api-reference/layout-related-objects/layout/loadfrommemory-method)               | Restaure le contenu de l'objet à partir de la mémoire globale. <Note> *Windows uniquement.* </Note>       |
| [SaveToArray](/fr/fine-reader/engine/api-reference/layout-related-objects/layout/savetoarray-method)                     | Enregistre le contenu de l'objet sous la forme d'un tableau d'octets.                                     |
| [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)               | Enregistre le contenu de l'objet dans la mémoire globale. <Note> *Windows uniquement.* </Note>            |
| [SaveToStream](/fr/fine-reader/engine/api-reference/layout-related-objects/layout/savetostream-method)                   | Enregistre le contenu de l'objet dans le flux.                                                            |

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

<div id="windows">
  ### Windows
</div>

<img src="https://mintcdn.com/abbyy/lsETHFYUFiongXSm/images/fine-reader/engine/layout.gif?s=fae7c3d1b6741051e7ce93e8298de134" alt="Layout" width="488" height="319" data-path="images/fine-reader/engine/layout.gif" />[](/fr/fine-reader/engine/api-reference/document-related-objects/frpage#layout)[](/fr/fine-reader/engine/api-reference/layout-related-objects/autoanalysisblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/rasterpictureblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/barcodeblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/tableblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/textblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/block)[](/fr/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/fr/fine-reader/engine/api-reference/layout-related-objects/vectorpictureblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/rasterpictureblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/checkmarkblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup)[](/fr/fine-reader/engine/api-reference/layout-related-objects/barcodeblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/block)[](/fr/fine-reader/engine/api-reference/layout-related-objects/tableblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/textblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/block)[](/fr/fine-reader/engine/api-reference/layout-related-objects/separatorblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/separatorgroup)[](/fr/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/fr/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/fr/fine-reader/engine/api-reference/document-related-objects/frpage)[](/fr/fine-reader/engine/api-reference/document-related-objects/frpages)[](/fr/fine-reader/engine/api-reference/document-related-objects/frdocument)

<div id="linux-and-macos">
  ### Linux et macOS
</div>

<img src="https://mintcdn.com/abbyy/lsETHFYUFiongXSm/images/fine-reader/engine/layoutlinuxmac.gif?s=b17a4f40c3b3d7c9736d9d77586ec003" alt="LayoutLinuxMac" width="338" height="272" data-path="images/fine-reader/engine/layoutlinuxmac.gif" />[](/fr/fine-reader/engine/api-reference/layout-related-objects/vectorpictureblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/rasterpictureblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/barcodeblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/tableblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/textblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/block)[](/fr/fine-reader/engine/api-reference/layout-related-objects/block)[](/fr/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/fr/fine-reader/engine/api-reference/layout-related-objects/separatorblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/separatorgroup)[](/fr/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/fr/fine-reader/engine/api-reference/document-related-objects/frpage#layout)[](/fr/fine-reader/engine/api-reference/document-related-objects/frpage)[](/fr/fine-reader/engine/api-reference/document-related-objects/frpages)[](/fr/fine-reader/engine/api-reference/document-related-objects/frdocument)

[Diagramme d'objet](/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 de la méthode [CreateLayoutFromStream](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlayoutfromstream-method) de l'objet [Engine](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface).

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

<Accordion title="C# code">
  ```csharp theme={null}
  FREngine.IFRDocument frdoc;
  // Itère sur les blocs du Layout
  for (int iPage = 0; iPage < frDoc.Pages.Count; iPage++)
  {
   FREngine.IFRPage page = frDoc.Pages[iPage];
   FREngine.ILayout layout = page.Layout;
   int blocksCount = layout.Blocks.Count;
   for (int iBlock = 0; iBlock < blocksCount; iBlock++)
   {
    FREngine.IBlock block = layout.Blocks[iBlock];
    ...
   }
  }
  ```
</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), [RecognizedTextProcessing](/fr/fine-reader/engine/guided-tour/samples#recognizedtextprocessing) ; et dans les Demo Tools : [Engine Predefined Processing Profiles](/fr/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles)

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

[Utilisation de Layout et des Blocks](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-layout-and-blocks)

[LayoutBlocks](/fr/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)

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