Vai al contenuto principale
Questo oggetto consente di accedere a proprietà specifiche di un Block di tabella. L’interfaccia ITableBlock deriva dall’interfaccia IBlock e ne eredita tutte le proprietà. La regione dei Block di questo tipo può essere costituita da un solo rettangolo. La struttura della tabella è descritta da due raccolte di Separator di tabella, orizzontali e verticali (le proprietà HSeparators e VSeparators), e da una raccolta di celle della tabella (la proprietà Cells). Ogni cella della tabella è trattata come un Block di un determinato tipo. Il numero di righe (colonne) nella tabella è uguale al numero di Separator orizzontali (verticali) meno 1. Il testo riconosciuto è una proprietà di una singola cella, non dell’intera tabella. Per accedere al testo riconosciuto di un Block di tabella, procedi come segue:
  1. Ottieni la raccolta di celle della tabella tramite la proprietà Cells.
  2. Seleziona la cella desiderata. Usa i metodi dell’oggetto TableCells.
  3. Ottieni l’oggetto Block della cella (la proprietà ITableCell::Block).
  4. Verifica che il Block sia di tipo BT_Text (la proprietà IBlock::Type) e ottieni l’oggetto TextBlock usando il metodo IBlock::GetAsTextBlock.
  5. Usa la proprietà ITextBlock::Text.

​
Proprietà

NomeTipoDescrizione
CellsTableCells, di sola letturaConsente di accedere alla raccolta di celle del Block di tabella. La raccolta contiene sempre almeno una cella, anche se nella tabella non sono presenti Separator. Le celle della raccolta sono disposte nel normale ordine logico di lettura.
HSeparatorsTableSeparators, di sola letturaConsente di accedere alla raccolta di Separator orizzontali del Block di tabella. Questa raccolta contiene sempre almeno due Separator, corrispondenti ai bordi superiore e inferiore del Block di tabella.
VSeparatorsTableSeparators, di sola letturaConsente di accedere alla raccolta di Separator verticali del Block di tabella. Questa raccolta contiene sempre almeno due Separator, corrispondenti ai bordi sinistro e destro del Block di tabella.

​
Metodi

NomeDescrizione
FindBaseCellFromPointConsente di individuare la posizione della cella nella griglia di base a partire da un pixel dell’immagine. Per griglia di base si intende la griglia formata dai bordi della tabella e dai Separator. Ogni separatore verticale incrementa di uno la coordinata orizzontale e ogni separatore orizzontale incrementa di uno la coordinata verticale. Gli assi delle coordinate sono orientati da sinistra a destra e dall’alto verso il basso.
InitializeGridInizializza la griglia della tabella per il Block di tabella.

​
Windows

TableBlock

​
Linux e macOS

TableBlockLinuxMac Diagramma degli oggetti

​
Parametro di output

Questo oggetto è il parametro di output del metodo GetAsTableBlock dell’oggetto Block.

​
Esempi

FREngine.IBlock block;
// Recupero dei blocchi delle celle della tabella
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;
  // eseguire un'operazione sul blocco della cella
 }
}
L’oggetto viene utilizzato nei seguenti esempi di codice:

​
Vedi anche

Block Lavorare con il Layout e i Block Lavorare con il Testo Lavorare con le proprietà