TableBlock オブジェクト (ITableBlock インターフェイス)

ABBYY FineReader Engine API の TableBlock オブジェクト (ITableBlock インターフェイス) です。テーブルブロックを表し、水平方向および垂直方向の区切り線コレクション (HSeparators、VSeparators) とセルのコレクション (Cells) を公開します。認識されたテキストには TableCell ごとにアクセスします。IBlock から派生しています。

このオブジェクトは、テーブルブロックの特定のプロパティへのアクセスを提供します。ITableBlock インターフェイスは IBlock インターフェイスから派生しており、そのすべてのプロパティを継承します。

このタイプのブロックの Region は、1 つの Rectangle のみで構成されます。テーブルの構造は、水平および垂直のテーブル区切り線の 2 つのコレクション (HSeparators プロパティおよび VSeparators プロパティ) と、テーブルセルのコレクション (Cells プロパティ) によって記述されます。各テーブルセルは、特定の型のブロックとして扱われます。テーブルの行数 (列数) は、水平 (垂直) 区切り線の数から 1 を引いた値に等しくなります。

認識されたテキストは、テーブル全体ではなく個々のセルのプロパティです。テーブルブロックの認識されたテキストにアクセスするには、次の手順を実行します。

1. Cells プロパティを使用して、テーブルセルのコレクションを取得します。
2. 目的のセルを選択します。TableCells オブジェクトのメソッドを使用してください。
3. セルのブロックオブジェクト (ITableCell::Block プロパティ) を取得します。
4. ブロックの型が BT_Text であることを確認し (IBlock::Type プロパティ) 、IBlock::GetAsTextBlock メソッドを使用して TextBlock オブジェクトを取得します。
5. ITextBlock::Text プロパティを使用します。

​

Properties

Name	Type	Description
Cells	TableCells, 読み取り専用	テーブルブロックのセルコレクションへのアクセスを提供します。テーブルに区切り線がない場合でも、コレクションには常に少なくとも1つのセルが含まれます。コレクション内のセルは論理的な読み取り順序で並んでいます。
HSeparators	TableSeparators, 読み取り専用	テーブルブロックの水平区切り線コレクションへのアクセスを提供します。このコレクションには、テーブルブロックの上端と下端に対応する区切り線が常に少なくとも2本含まれます。
VSeparators	TableSeparators, 読み取り専用	テーブルブロックの垂直区切り線コレクションへのアクセスを提供します。このコレクションには、テーブルブロックの左端と右端の境界に対応する区切り線が常に少なくとも2本含まれます。

​

メソッド

名前	説明
FindBaseCellFromPoint	画像上のピクセルからベースグリッド内のセル位置を検索します。ここでのベースグリッドとは、テーブルの境界線と区切り線によって形成されるグリッドを指します。垂直方向の区切り線は水平座標を1つずつ増加させ、水平方向の区切り線は垂直座標を1つずつ増加させます。座標軸は左から右、上から下の方向に設定されています。
InitializeGrid	テーブルブロックのテーブルグリッドを初期化します。

​

関連オブジェクト

​

Windows

​

Linux および macOS

オブジェクト図

​

出力パラメーター

このオブジェクトは、Block オブジェクトの GetAsTableBlock メソッドの出力パラメーターです。

​

サンプル

C# コード

FREngine.IBlock block;
// テーブルセルブロックの取得
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;
  // セルブロックに対して処理を行う
 }
}

このオブジェクトは以下のコード サンプルで使用されています。

• Windows: RecognizedTextProcessing、およびデモ ツール: Engine Predefined Processing Profiles。

​

関連項目

Block

Working with Layout and Blocks

Working with Text

Working with Properties