Vai al contenuto principale
Questo oggetto consente di accedere a proprietà specifiche di un blocco di testo. Questi blocchi corrispondono a un’area dell’immagine riconosciuta come testo formattato. Tramite questo oggetto è inoltre possibile accedere al testo riconosciuto nella parte dell’immagine racchiusa dal blocco. L’interfaccia ITextBlock deriva dall’interfaccia IBlock e ne eredita tutte le proprietà. Le proprietà di questo oggetto possono essere suddivise in due gruppi:
  • le proprietà che influiscono sul processo di riconoscimento del testo nel blocco. Si tratta di ImageProcessingParams, AnalysisParams e RecognizerParams. Queste proprietà consentono di impostare parametri di elaborazione speciali per un singolo blocco.
  • le proprietà che possono essere impostate dopo l’analisi e prima del riconoscimento, oppure valorizzate dal programma durante il riconoscimento. Tra queste vi sono BlockRole e BusinessCardFieldType, usate per specificare il ruolo del blocco nei diversi tipi di documenti. Anche la proprietà TextOrientation appartiene a questo gruppo.
  • i risultati del riconoscimento. Questo gruppo contiene solo la proprietà Text, che rappresenta il testo riconosciuto del blocco.

​
Proprietà

Nome

Tipo

Descrizione

Impostazioni di elaborazione

AnalysisParams

TextBlockAnalysisParams

Consente di accedere ai parametri di analisi del blocco di testo.

ImageProcessingParams

ImageProcessingParams

Consente di accedere ai parametri di pre-elaborazione dell’immagine del blocco di testo.

RecognizerParams

RecognizerParams

Consente di accedere ai parametri di riconoscimento del blocco di testo.

Ruolo e orientamento del testo

BlockRole

BlockRoleEnum

Specifica il ruolo del blocco di testo nella struttura logica di un documento.

Per impostazione predefinita, è BR_Unknown.

BusinessCardFieldType

BusinessCardFieldTypeEnum

Consente di accedere al ruolo del blocco di testo come parte di un biglietto da visita.

Quando viene chiamato il metodo IFRPage::SynthesizeBusinessCard, FineReader Engine presume che il blocco con il ruolo specificato in un biglietto da visita corrisponda a un field del tipo appropriato. Se il blocco non può essere considerato un field di questo tipo, il suo testo non comparirà nel testo del biglietto da visita.

Per impostazione predefinita, è BCFT_Unknown.

TextOrientation

TextOrientation

Specifica l’orientamento del testo nel blocco. Se lo si imposta prima del riconoscimento, influirà sul modo in cui il testo nel blocco viene interpretato (ad esempio, in righe o in colonne); altrimenti, conterrà l’orientamento rilevato dopo il riconoscimento.

Risultati del riconoscimento

Text

Text, di sola lettura

Contiene il testo riconosciuto del blocco di testo.

​
Metodi

NomeDescrizione
CopyFromInizializza le proprietà dell’oggetto corrente con i valori delle proprietà corrispondenti di un altro oggetto.

​
Windows

TextBlock

​
Linux e macOS

TextBlockLinuxMac Diagramma degli oggetti

​
Parametro di output

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

​
Esempi

int totalCharsCount = 0;
FREngine.IBlock block;
// Calcola il numero di caratteri in un testo
if (block.Type == FREngine.BlockTypeEnum.BT_Text)
{
 FREngine.ITextBlock textBlock = block.GetAsTextBlock();
 int paragraphsCount = textBlock.Text.Paragraphs.Count;
 for (int iPar = 0; iPar < paragraphsCount; iPar++)
 {
  FREngine.IParagraph par = textBlock.Text.Paragraphs[iPar];
  string text = par.Text;
  totalCharsCount += text.Length;
 }
}
L’oggetto viene utilizzato nei seguenti esempi di codice:

​
Vedi anche

Block Utilizzo di Layout e Block Utilizzo di Proprietà