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

# Layout-Objekt (ILayout-Schnittstelle)

> Layout-Objekt (ILayout-Schnittstelle) in der ABBYY FineReader Engine API — Stammcontainer für Blöcke im Layout eines Bildes; stellt Blocksammlungen (Blocks, BlackSeparators, SortedBlocks, VisualBlocks), Width/Height, Name, TextAsString und PageRegion bereit; ein persistentes Objekt, das in einer Datei, im Speicher oder in einem Stream gespeichert werden kann.

Dieses Objekt stellt Methoden und Eigenschaften für die Arbeit mit dem Bildlayout bereit. Das Layout-Objekt dient als Ausgangspunkt für Blöcke. Zu seinen Attributen gehören width und height. Diese Parameter werden auf die entsprechenden Parameter der Schwarzweißseite des Bildes gesetzt, für die das Layout-Objekt definiert ist. Dies geschieht automatisch, wenn das Layout-Objekt analysiert oder erkannt wird.

Das Layout-Objekt ist ein persistentes Objekt. Das bedeutet, dass der aktuelle Zustand des Objekts in persistentem Speicher gespeichert werden kann. Später kann das Objekt neu erstellt werden, indem sein Zustand aus dem persistenten Speicher gelesen wird. Die folgenden Methoden ermöglichen die Persistenz des Objekts:

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

<div id="properties">
  ## Eigenschaften
</div>

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

      <th>
        <p>
          <strong>Typ</strong>
        </p>
      </th>

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

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

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

          ,{" "}

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

      <td>
        <p>
          Gibt das <strong>Engine</strong>-Objekt zurück.
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>Block-Sammlungen</em>
        </p>
      </td>
    </tr>

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

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

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/api-reference/layout-related-objects/layoutblocks">
              LayoutBlocks
            </a>
          </strong>

          ,{" "}

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

      <td>
        <p>
          Ermöglicht den Zugriff auf die Sammlung der Trennlinien- und Trennliniengruppen-Blöcke des Layouts.
        </p>

        <p>
          Diese Eigenschaft verweist auf ein gültiges Objekt, unabhängig davon, ob im <strong>Layout</strong> Trennlinienblöcke vorhanden sind oder nicht. Sind im <strong>Layout</strong> keine Trennlinien vorhanden, ist die Eigenschaft{" "}
          <strong>BlackSeparators</strong> leer.
        </p>
      </td>
    </tr>

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

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

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/api-reference/layout-related-objects/layoutblocks">
              LayoutBlocks
            </a>
          </strong>

          ,{" "}

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

      <td>
        <p>
          Ermöglicht den Zugriff auf die Sammlung der Blöcke des Layouts. Diese Sammlung enthält keine Trennlinien- und Trennliniengruppen-Blöcke. Um auf diese Blöcke zuzugreifen, verwenden Sie die Eigenschaft{" "}
          <strong>BlackSeparators</strong>.
        </p>

        <p>
          Diese Eigenschaft verweist auf ein gültiges Objekt, unabhängig davon, ob im <strong>Layout</strong> Blöcke vorhanden sind oder nicht. Sind im <strong>Layout</strong> keine Blöcke vorhanden, ist die Eigenschaft{" "}
          <strong>Blocks</strong> leer. Siehe auch{" "}

          <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            Arbeiten mit schreibgeschützten Objekteigenschaften
          </a>

          .
        </p>

        <Note>
          Diese Sammlung enthält niemals Autoanalyse-Blöcke, da dieser Blocktyp ausschließlich in Visual Components verwendet wird.
        </Note>
      </td>
    </tr>

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

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/api-reference/layout-related-objects/layoutblocks">
              LayoutBlocks
            </a>
          </strong>

          ,{" "}

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

      <td>
        <p>
          Gibt die logisch geordnete Sammlung der Blöcke des Layouts zurück.
        </p>

        <p>
          Diese Sammlung enthält dieselben Blöcke, die von der Eigenschaft{" "}
          <strong>Blocks</strong> zurückgegeben werden. Sie sind nach der Position der oberen linken Ecke jedes Blocks sortiert – zunächst von links nach rechts, dann von oben nach unten. Blöcke, die nah beieinander liegen, werden als Teil einer logischen Gruppe betrachtet.
        </p>
      </td>
    </tr>

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

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

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/api-reference/layout-related-objects/layoutblocks">
              LayoutBlocks
            </a>
          </strong>

          ,{" "}

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

      <td>
        <Warning>
          Visual Components werden derzeit nur unter Windows unterstützt.
        </Warning>

        <p>
          Ermöglicht den Zugriff auf die Sammlung der in Visual Components sichtbaren Blöcke. Diese Sammlung kann Blöcke der folgenden Typen enthalten: Text, Tabelle, Rasterbild, Barcode, Autoanalyse. Die Reihenfolge der Blöcke in dieser Sammlung entspricht der Darstellung in Visual Components.
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="3">
        <p>
          <em>Zusätzliche Attribute</em>
        </p>
      </td>
    </tr>

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

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

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

          , nur lesbar
        </p>
      </td>

      <td>
        <p>
          Gibt die Layouthöhe in Pixeln zurück. Sie entspricht der Höhe von{" "}

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

          {" "}

          der entsprechenden{" "}

          <strong>
            <a href="/de/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="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              BSTR
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>Speichert den Layoutnamen.</p>
      </td>
    </tr>

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

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

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

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

      <td>
        <p>
          Schreibt den Text aus allen Text- und Tabellenblöcken in eine Zeile. Das{" "}

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

          {" "}

          -Objekt legt die Reihenfolge fest, in der Text aus Tabellenzellen geschrieben wird.
          Die Reihenfolge stimmt daher nicht notwendigerweise mit der Reihenfolge der Tabellenzellen im
          Bild überein. Text aus Barcode-Blöcken wird nicht geschrieben.
        </p>
      </td>
    </tr>

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

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

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region">
              Region
            </a>
          </strong>

          ,{" "}

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

      <td>
        <p>
          Speichert die umgebende Region der Blöcke des Layouts. Sind keine
          Blöcke vorhanden, gibt diese Eigenschaft die leere Region zurück.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>
            <a href="/de/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>
          Ermöglicht die Verknüpfung beliebiger benutzerdefinierter Informationen mit einem Objekt des
          Typs <strong>Layout</strong>.
        </p>
      </td>
    </tr>

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

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

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

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

      <td>
        <p>
          Gibt die Layout-Breite in Pixeln zurück. Sie entspricht der Breite von{" "}

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

          {" "}

          der zugehörigen{" "}

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

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

<div id="methods">
  ## Methoden
</div>

| Name                                                                                                                     | Beschreibung                                                                                                             |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| [Clean](/de/fine-reader/engine/api-reference/layout-related-objects/layout/clean-method)                                 | Entfernt alle Arten von Blöcken und Trennlinien aus dem Layout.                                                          |
| [CopyFrom](/de/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method) | Initialisiert die Eigenschaften des aktuellen Objekts mit den Werten entsprechender Eigenschaften eines anderen Objekts. |
| [LoadFromFile](/de/fine-reader/engine/api-reference/layout-related-objects/layout/loadfromfile-method)                   | Stellt den Inhalt des Objekts aus einer Datei auf dem Datenträger wieder her.                                            |
| [LoadFromMemory](/de/fine-reader/engine/api-reference/layout-related-objects/layout/loadfrommemory-method)               | Stellt den Inhalt des Objekts aus dem globalen Speicher wieder her. <Note> *Nur unter Windows.* </Note>                  |
| [SaveToArray](/de/fine-reader/engine/api-reference/layout-related-objects/layout/savetoarray-method)                     | Speichert den Inhalt des Objekts als Byte-Array.                                                                         |
| [SaveToFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                   | Speichert den Inhalt des Objekts in einer Datei auf dem Datenträger.                                                     |
| [SaveToMemory](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method)               | Speichert den Inhalt des Objekts im globalen Speicher. <Note> *Nur unter Windows.* </Note>                               |
| [SaveToStream](/de/fine-reader/engine/api-reference/layout-related-objects/layout/savetostream-method)                   | Speichert den Inhalt des Objekts in den Stream.                                                                          |

<div id="related-objects">
  ## Verwandte Objekte
</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" />[](/de/fine-reader/engine/api-reference/document-related-objects/frpage#layout)[](/de/fine-reader/engine/api-reference/layout-related-objects/autoanalysisblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/rasterpictureblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/barcodeblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/tableblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/textblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/block)[](/de/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/de/fine-reader/engine/api-reference/layout-related-objects/vectorpictureblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/rasterpictureblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/checkmarkblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/checkmarkgroup)[](/de/fine-reader/engine/api-reference/layout-related-objects/barcodeblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/block)[](/de/fine-reader/engine/api-reference/layout-related-objects/tableblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/textblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/block)[](/de/fine-reader/engine/api-reference/layout-related-objects/separatorblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/separatorgroup)[](/de/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/de/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/de/fine-reader/engine/api-reference/document-related-objects/frpage)[](/de/fine-reader/engine/api-reference/document-related-objects/frpages)[](/de/fine-reader/engine/api-reference/document-related-objects/frdocument)

<div id="linux-and-macos">
  ### Linux und 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" />[](/de/fine-reader/engine/api-reference/layout-related-objects/vectorpictureblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/rasterpictureblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/barcodeblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/tableblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/textblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/block)[](/de/fine-reader/engine/api-reference/layout-related-objects/block)[](/de/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/de/fine-reader/engine/api-reference/layout-related-objects/separatorblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/separatorgroup)[](/de/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/de/fine-reader/engine/api-reference/document-related-objects/frpage#layout)[](/de/fine-reader/engine/api-reference/document-related-objects/frpage)[](/de/fine-reader/engine/api-reference/document-related-objects/frpages)[](/de/fine-reader/engine/api-reference/document-related-objects/frdocument)

[Objektdiagramm](/de/fine-reader/engine/api-reference/object-diagram)

<div id="output-parameter">
  ## Ausgabeparameter
</div>

Dieses Objekt ist der Ausgabeparameter der [CreateLayoutFromStream](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlayoutfromstream-method)-Methode des [Engine](/de/fine-reader/engine/api-reference/engine-object-iengine-interface)-Objekts.

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

<Accordion title="C# code">
  ```csharp theme={null}
  FREngine.IFRDocument frdoc;
  // Durchläuft die Blöcke des Layouts
  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>

Das Objekt wird in den folgenden Codebeispielen verwendet:

* Linux: [CustomLanguage](/de/fine-reader/engine/guided-tour/samples#customlanguage)
* Windows: [CustomLanguage](/de/fine-reader/engine/guided-tour/samples#customlanguage), [RecognizedTextProcessing](/de/fine-reader/engine/guided-tour/samples#recognizedtextprocessing); und in den Demo Tools: [Engine Predefined Processing Profiles](/de/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles)

<div id="see-also">
  ## Siehe auch
</div>

[Arbeiten mit Layout und Block](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-layout-and-blocks)

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

[Arbeiten mit Eigenschaften](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)