TableBlock-Objekt (ITableBlock-Schnittstelle)

TableBlock-Objekt (ITableBlock-Schnittstelle) in der ABBYY FineReader Engine API — stellt einen Tabellenblock dar; bietet Sammlungen horizontaler und vertikaler Trennlinien (HSeparators, VSeparators) sowie eine Sammlung von Zellen (Cells); auf erkannten Text wird zellenweise über TableCell zugegriffen; abgeleitet von IBlock.

Dieses Objekt bietet Zugriff auf bestimmte Eigenschaften eines Tabellenblocks. Die ITableBlock-Schnittstelle ist von der IBlock-Schnittstelle abgeleitet und erbt alle ihre Eigenschaften.

Der Bereich von Blöcken dieses Typs kann nur aus einem einzigen Rechteck bestehen. Die Struktur der Tabelle wird durch zwei Sammlungen von Tabellentrennlinien beschrieben – horizontale und vertikale (die Eigenschaften HSeparators und VSeparators) – sowie durch eine Sammlung von Tabellenzellen (die Eigenschaft Cells). Jede Tabellenzelle wird als Block eines bestimmten Typs behandelt. Die Anzahl der Zeilen (Spalten) in der Tabelle entspricht der Anzahl der horizontalen (vertikalen) Trennlinien minus 1.

Der erkannte Text ist eine Eigenschaft einer einzelnen Zelle, nicht der gesamten Tabelle. Um auf den erkannten Text eines Tabellenblocks zuzugreifen, gehen Sie wie folgt vor:

1. Rufen Sie die Sammlung der Tabellenzellen über die Eigenschaft Cells ab.
2. Wählen Sie die gewünschte Zelle aus. Verwenden Sie dazu die Methoden des Objekts TableCells.
3. Rufen Sie das Blockobjekt der Zelle ab (die Eigenschaft ITableCell::Block).
4. Vergewissern Sie sich, dass der Block vom Typ BT_Text ist (die Eigenschaft IBlock::Type), und rufen Sie dann das Objekt TextBlock mithilfe der Methode IBlock::GetAsTextBlock ab.
5. Verwenden Sie die Eigenschaft ITextBlock::Text.

​

Eigenschaften

Name	Typ	Beschreibung
Cells	TableCells, nur lesbar	Ermöglicht den Zugriff auf die Sammlung der Zellen des Tabellenblocks. Die Sammlung enthält immer mindestens eine Zelle, auch wenn die Tabelle keine Trennlinien enthält. Die Zellen in der Sammlung sind in logischer Lesereihenfolge angeordnet.
HSeparators	TableSeparators, nur lesbar	Ermöglicht den Zugriff auf die Sammlung horizontaler Trennlinien des Tabellenblocks. Diese Sammlung enthält immer mindestens zwei Trennlinien, die der oberen und unteren Begrenzung des Tabellenblocks entsprechen.
VSeparators	TableSeparators, nur lesbar	Ermöglicht den Zugriff auf die Sammlung vertikaler Trennlinien des Tabellenblocks. Diese Sammlung enthält immer mindestens zwei Trennlinien, die der linken und rechten Begrenzung des Tabellenblocks entsprechen.

​

Methoden

Name	Beschreibung
FindBaseCellFromPoint	Ermöglicht das Ermitteln der Zellposition im Grundraster ausgehend von einem Pixel im Bild. Mit Grundraster ist hier das Raster gemeint, das durch Tabellenränder und Trennlinien gebildet wird. Jede vertikale Trennlinie erhöht die horizontale Koordinate um eins, und jede horizontale Trennlinie erhöht die vertikale Koordinate um eins. Die Koordinatenachsen verlaufen von links nach rechts und von oben nach unten.
InitializeGrid	Initialisiert das Tabellenraster für den Tabellenblock.

​

Verwandte Objekte

​

Windows

​

Linux und macOS

Objektdiagramm

​

Ausgabeparameter

Dieses Objekt ist der Ausgabeparameter der Methode GetAsTableBlock des Objekts Block.

​

Beispiele

C# code

FREngine.IBlock block;
// Blöcke von Tabellenzellen abrufen
if (block.Type == FREngine.BlockTypeEnum.BT_Table)
{
 FREngine.ITableBlock tableBlock = block.GetAsTableBlock();
 for (int iCell = 0; iCell < tableBlock.Cells.Count; iCell++)
 {
  FREngine.IBlock cell = tableBlock.Cells[iCell].Block;
  // etwas mit dem Zellenblock machen
 }
}

Das Objekt wird in den folgenden Codebeispielen verwendet:

• Windows: RecognizedTextProcessing; und Demo Tools: Engine Predefined Processing Profiles.

​

Siehe auch

Block

Arbeiten mit Layout und Blöcken

Arbeiten mit Text

Arbeiten mit Eigenschaften