Vai al contenuto principale
Questo oggetto rappresenta il testo riconosciuto. Il testo riconosciuto è una raccolta di paragrafi. È possibile accedere a questa raccolta tramite la proprietà Paragraphs. Inoltre, questo oggetto espone proprietà per accedere a diversi attributi del testo e metodi che consentono di eseguire operazioni su di esso, come la suddivisione verticale e orizzontale, la rimozione di intervalli e così via. L’oggetto Testo può esistere in modo indipendente oppure essere un sotto-oggetto di un altro oggetto che rappresenta un’unità del layout (blocco di testo, cella di tabella e così via). Una posizione nel testo è definita dalla “coppia di coordinate” (paragraph;symbol). Esiste anche la cosiddetta “posizione speciale”, per la quale paragraph=<il numero di paragrafi>, symbol=0.
Questo oggetto è disponibile tramite un blocco di testo riconosciuto. È inoltre possibile accedere al testo completo riconosciuto del documento o della pagina in uno speciale formato “plain text” tramite l’oggetto PlainText.

​
Proprietà

,read-only

Restituisce l’oggetto Engine.

Specifica se i colori dell’intero testo sono invertiti. Questo attributo viene impostato su TRUE se il testo riconosciuto appartiene a un blocco o a una cella di tabella che presenta anch’essa l’attributo inverted. Può essere utilizzato nell’interfaccia utente per visualizzare il testo con carattere bianco su sfondo nero.

È possibile modificare questa proprietà solo se l’oggetto Text è stato ricevuto tramite la proprietàITextBlock::TextIn caso contrario, la proprietà è di sola lettura.

,read-only

Fornisce accesso alla raccolta di paragrafi dell’oggetto Text. Ogni oggetto Text, anche uno vuoto, contiene un sottooggetto valido di tipo Paragraphs . Questo oggetto è una raccolta di oggettie può non contenere alcun elemento. L’oggetto Paragraph rappresenta un paragrafo nel testo riconosciuto. È attraverso questo oggetto che è possibile ottenere il contenuto del testo riconosciuto.

Memorizza l’orientamento del testo. Viene utilizzato internamente da ABBYY FineReader Engine durante l’esportazione del testo riconosciuto.

Questa proprietà è significativa solo dopo il riconoscimento, ma non è possibile modificare l’orientamento del testo già riconosciuto. Per specificare l’orientamento della pagina prima del riconoscimento, utilizzare la proprietàdell’oggetto ImageProcessingParams. Per specificare l’orientamento del testo in un determinato blocco di testo, impostare la proprietàprima del riconoscimento.

L’unico scenario in cui è necessario impostare il valore di questa proprietà è quando si desidera inserire del testo aggiuntivo che deve comparire nel file esportato. Dopo aver aggiunto il testo, specificarne l’orientamento tramite questa proprietà e chiamare un metodo che esegua la sintesi prima di esportare il documento.

Note:

  • La proprietà restituisce un oggetto costante. Per modificare l’orientamento del testo, è necessario prima ottenere un oggetto TextOrientation intermedio tramite il metodomodificare i parametri necessari e quindi assegnare l’oggetto ottenuto alla proprietà.
  • È possibile modificare questa proprietà solo se l’oggetto Text è stato ricevuto tramite la proprietàIn caso contrario, la proprietà è di sola lettura.
  • L’oggetto TextOrientation con la proprietàuguale a RT_UnknownRotation o la proprietàuguale a TRT_Unknown non può essere assegnato a questa proprietà.

​
Metodi

NomeDescrizione
AppendEmptyParagraphAggiunge un paragrafo vuoto alla fine del testo corrente.
GetRangeRestituisce una copia di un intervallo di testo.
RemoveRimuove un intervallo dal testo corrente.
RemoveAllRimuove tutti i paragrafi dal testo corrente.
Testo Diagramma degli oggetti

​
Parametro di input

Questo oggetto è il parametro di input del metodo InsertText dell’oggetto Paragraph.

​
Esempi

FREngine.IBlock block;
int suspiciousCharsCount = 0;
// Scorre i paragrafi di un blocco di testo e ne ottiene il testo
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;
 // esegue un'operazione sul testo
}
L’oggetto viene utilizzato nei seguenti esempi di codice:

​
Vedi anche

Lavorare con il testo Lavorare con le proprietà