Zum Hauptinhalt springen
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:

​
Eigenschaften

,nur lesbar

Gibt das Engine-Objekt zurück.

,nur lesbar

Ermöglicht den Zugriff auf die Sammlung der Trennlinien- und Trennliniengruppen-Blöcke des Layouts.

Diese Eigenschaft verweist auf ein gültiges Objekt, unabhängig davon, ob im Layout Trennlinienblöcke vorhanden sind oder nicht. Sind im Layout keine Trennlinien vorhanden, ist die Eigenschaft BlackSeparators leer.

,nur lesbar

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

Diese Eigenschaft verweist auf ein gültiges Objekt, unabhängig davon, ob im Layout Blöcke vorhanden sind oder nicht. Sind im Layout keine Blöcke vorhanden, ist die Eigenschaft Blocks leer. Siehe auchArbeiten mit schreibgeschützten Objekteigenschaften.

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

,nur lesbar

Gibt die logisch geordnete Sammlung der Blöcke des Layouts zurück.

Diese Sammlung enthält dieselben Blöcke, die von der Eigenschaft Blocks 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.

,nur lesbar

Visual Components werden derzeit nur unter Windows unterstützt.

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.

, nur lesbar

Gibt die Layouthöhe in Pixeln zurück. Sie entspricht der Höhe vonder entsprechenden.

Speichert den Layoutnamen.

, read-only

Schreibt den Text aus allen Text- und Tabellenblöcken in eine Zeile. Das-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.

,read-only

Speichert die umgebende Region der Blöcke des Layouts. Sind keine Blöcke vorhanden, gibt diese Eigenschaft die leere Region zurück.

Ermöglicht die Verknüpfung beliebiger benutzerdefinierter Informationen mit einem Objekt des Typs Layout.

, read-only

Gibt die Layout-Breite in Pixeln zurück. Sie entspricht der Breite vonder zugehörigen.

​
Methoden

NameBeschreibung
CleanEntfernt alle Arten von Blöcken und Trennlinien aus dem Layout.
CopyFromInitialisiert die Eigenschaften des aktuellen Objekts mit den Werten entsprechender Eigenschaften eines anderen Objekts.
LoadFromFileStellt den Inhalt des Objekts aus einer Datei auf dem Datenträger wieder her.
LoadFromMemory <Note> Nur unter Windows. </Note>Stellt den Inhalt des Objekts aus dem globalen Speicher wieder her.
SaveToArraySpeichert den Inhalt des Objekts als Byte-Array.
SaveToFileSpeichert den Inhalt des Objekts in einer Datei auf dem Datenträger.
SaveToMemory <Note> Nur unter Windows. </Note>Speichert den Inhalt des Objekts im globalen Speicher.
SaveToStreamSpeichert den Inhalt des Objekts in den Stream.

​
Windows

Layout

​
Linux und macOS

LayoutLinuxMac Objektdiagramm

​
Ausgabeparameter

Dieses Objekt ist der Ausgabeparameter der CreateLayoutFromStream-Methode des Engine-Objekts.

​
Beispiele

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];
  ...
 }
}
Das Objekt wird in den folgenden Codebeispielen verwendet:

​
Siehe auch

Arbeiten mit Layout und Block LayoutBlocks Arbeiten mit Eigenschaften