Objet TableBlock (interface ITableBlock)

Objet TableBlock (interface ITableBlock) dans l’API ABBYY FineReader Engine — Représente un bloc de tableau ; expose des collections de séparateurs horizontaux et verticaux (HSeparators, VSeparators) et une collection de cellules (Cells) ; le texte reconnu est accessible cellule par cellule via TableCell ; dérivé de IBlock.

Cet objet donne accès à des propriétés spécifiques d’un bloc de tableau. L’interface ITableBlock dérive de l’interface IBlock et hérite de toutes ses propriétés.

La région des blocs de ce type peut être constituée d’un seul rectangle uniquement. La structure du tableau est décrite par deux collections de séparateurs de tableau, horizontaux et verticaux (les propriétés HSeparators et VSeparators), ainsi que par une collection de cellules de tableau (la propriété Cells). Chaque cellule de tableau est traitée comme un bloc d’un certain type. Le nombre de lignes (colonnes) du tableau est égal au nombre de séparateurs horizontaux (verticaux) moins 1.

Le texte reconnu est une propriété d’une seule cellule, et non de l’ensemble du tableau. Pour accéder au texte reconnu d’un bloc de tableau, procédez comme suit :

1. Obtenez la collection de cellules de tableau à l’aide de la propriété Cells.
2. Sélectionnez la cellule souhaitée. Utilisez les méthodes de l’objet TableCells.
3. Obtenez l’objet bloc de la cellule (la propriété ITableCell::Block).
4. Vérifiez que le bloc est de type BT_Text (la propriété IBlock::Type) et obtenez l’objet TextBlock à l’aide de la méthode IBlock::GetAsTextBlock.
5. Utilisez la propriété ITextBlock::Text.

​

Propriétés

Nom	Type	Description
Cells	TableCells, lecture seule	Permet d’accéder à la collection de cellules du bloc de tableau. La collection contient toujours au moins une cellule, même si le tableau ne comporte aucun séparateur. Les cellules de la collection sont organisées selon l’ordre logique de lecture.
HSeparators	TableSeparators, lecture seule	Permet d’accéder à la collection de séparateurs horizontaux du bloc de tableau. Cette collection contient toujours au moins deux séparateurs correspondant aux limites supérieure et inférieure du bloc de tableau.
VSeparators	TableSeparators, lecture seule	Permet d’accéder à la collection de séparateurs verticaux du bloc de tableau. Cette collection contient toujours au moins deux séparateurs correspondant aux bordures gauche et droite du bloc de tableau.

​

Méthodes

Nom	Description
FindBaseCellFromPoint	Permet de trouver la position d’une cellule dans la grille de base à partir d’un pixel de l’image. Par grille de base, on entend ici la grille formée par les bordures du tableau et les séparateurs. Chaque séparateur vertical incrémente la coordonnée horizontale d’une unité, et chaque séparateur horizontal incrémente la coordonnée verticale d’une unité. Les axes de coordonnées sont orientés de gauche à droite et de haut en bas.
InitializeGrid	Initialise la grille du tableau pour le bloc de tableau.

​

Objets associés

​

Windows

​

Linux et macOS

Diagramme d’objets

​

Paramètre de sortie

Cet objet constitue le paramètre de sortie de la méthode GetAsTableBlock de l’objet Block.

​

Exemples

Code C#

FREngine.IBlock block;
// Récupération des blocs de cellule de tableau
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;
  // effectuer une opération sur le bloc de cellule
 }
}

L’objet est utilisé dans les exemples de code suivants :

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

​

Voir aussi

Block

Utilisation de Layout et des objets Block

Utilisation du texte

Utilisation des propriétés