Vai al contenuto principale
Questo oggetto espone metodi e proprietà per lavorare con un singolo paragrafo del testo riconosciuto. Un paragrafo nel modello a oggetti di ABBYY FineReader Engine è un’unità di testo elementare. Tramite questo oggetto, un utente può ottenere:
  • il testo riconosciuto (utilizzare la proprietà Text a questo scopo)
  • diversi parametri del paragrafo (proprietà ExtendedParams, ListParams, ParagraphStyle)
  • raccolte di righe e Words del paragrafo (proprietà Lines e Words)
  • i parametri di un singolo carattere (metodi GetCharParams, SetCharParams e GetDropCapCharParams)
  • segnalibri (proprietà Bookmark e UserBookmark)
  • Le coordinate dei bordi del paragrafo (proprietà Left, Top, Right, Bottom) non sono disponibili per i paragrafi dei barcode.
  • I segnalibri in ABBYY FineReader Engine sono entità interne (tecniche) o personalizzate con nomi codificati tramite parole chiave (prefissi). Tali parole chiave e il relativo vocabolario possono variare in base alla versione delle tecnologie utilizzate.

​
Properties

,read-only

Restituisce l’oggetto Engine.

, read-only

Fornisce accesso al testo riconosciuto del paragrafo sotto forma di stringa Unicode. È tramite questa proprietà che si ottiene il testo riconosciuto. La stringa può contenere i seguenti caratteri speciali:

  • 0x2028 — Simbolo di interruzione di riga
  • L’\n’ — Simbolo di interruzione di paragrafo
  • 0xFFFC — Carattere di sostituzione oggetto (indica un’immagine incorporata nel testo)
  • 0x0009 — Tabulazione.
  • 0x005E — Accento circonflesso (^), utilizzato da ABBYY FineReader Engine come sostituto per i caratteri non riconosciuti
  • 0x00AC — Trattino morbido
Se il paragrafo ha una direzione di scrittura da destra a sinistra (come per l’ebraico), il testo del paragrafo è una stringa che contiene i caratteri del paragrafo nell’ordine in cui vengono letti. Ad esempio, il testo ebraico Hebrew verrà restituito come stringa ”Hebrew_backtofront”.

Si noti che il testo riconosciuto può differire in misura trascurabile dall’originale. Alcuni simboli di input possono essere sostituiti con un carattere speciale. Ad esempio, il simbolo ”…” può essere sostituito con una tabulazione. Per questo motivo il numero di simboli nel testo riconosciuto può differire dall’originale. Per accedere alla parola di input senza simboli sostituiti, utilizzare.

,read-only

Fornisce accesso alla raccolta delle parole del paragrafo.

A differenza della proprietà Text, se il paragrafo ha una direzione di scrittura da destra a sinistra (come per l’ebraico), una parola nel paragrafo è una stringa che contiene i caratteri della parola da sinistra a destra. Ad esempio, la parola ebraica Hebrew verrà restituita come stringa ”Hebrew”.

,read-only

Fornisce accesso alla raccolta delle righe del paragrafo. La proprietà restituisce un oggetto costante.

, read-only

Restituisce il numero di segnalibri nel paragrafo.

, read-only

Fornisce accesso al segnalibro di qualsiasi tipo (tecnico o utente) tramite il suo indice nella raccolta interna dei segnalibri del paragrafo. Il segnalibro a cui si accede tramite questa proprietà contiene un prefisso nel nome.

,read-only

Restituisce un riferimento all’oggetto Hyperlink che descrive il collegamento ipertestuale nella posizione. Se non è presente alcun collegamento ipertestuale, questa proprietà è impostata su 0.

,read-only

Fornisce accesso a tutti i punti di tabulazione nel paragrafo.

, di sola lettura

Fornisce accesso al segnalibro utente tramite il relativo indice nella raccolta interna dei segnalibri del paragrafo. Il segnalibro a cui si accede tramite questa proprietà non contiene un prefisso nel nome.

, read-only

Restituisce il numero di segnalibri utente nel paragrafo.

, read-only

Questa proprietà contiene il numero di caratteri nel paragrafo. Questo valore corrisponde al numero di caratteri nella stringa ottenuta tramite la proprietà Text.

Il simbolo di interruzione di paragrafo alla fine del paragrafo è incluso nella proprietà Text e conteggiato nella proprietà Length.

Fornisce accesso ai parametri dell’oggetto Paragraph esposti dall’oggetto ParagraphParams.

,read-only

Fornisce accesso ai parametri dell’elenco a cui appartiene il paragrafo. Se il paragrafo non è incluso nell’elenco, la proprietà IListParams::List restituisce NULL.

Fornisce accesso ai parametri dello stile di paragrafo. Questi parametri diventano accessibili solo dopo la sintesi del documento.

La proprietà restituisce un oggetto costante.

Fornisce accesso al numero di caratteri nel capolettera di un paragrafo. I primi DropCapCharsCount simboli del paragrafo sono considerati capolettera. Questa proprietà non viene aggiornata quando il paragrafo viene modificato, pertanto il suo valore può essere maggiore della lunghezza del paragrafo.

, read-only

Contiene il numero della colonna a cui appartiene il carattere nella posizione specificata.

, read-only

Contiene la coordinata del bordo inferiore del paragrafo così come è posizionato nell’immagine.

Questa proprietà non è disponibile per i paragrafi dei barcode.

, di sola lettura

Memorizza la coordinata del bordo sinistro del paragrafo nella posizione in cui si trova nell’immagine.

Questa proprietà non è disponibile per i paragrafi dei barcode.

, di sola lettura

Memorizza la coordinata del bordo destro del paragrafo nella posizione in cui si trova nell’immagine.

Questa proprietà non è disponibile per i paragrafi dei barcode.

, di sola lettura

Memorizza la coordinata del bordo superiore del paragrafo nella posizione in cui si trova nell’immagine.

Questa proprietà non è disponibile per i paragrafi dei barcode.

​
Metodi

NomeDescrizione
DeleteBookmarkElimina il segnalibro specificato di qualsiasi tipo (tecnico o utente) dal paragrafo.
GetBookmarkRangeIndividua l’indice del carattere iniziale e la lunghezza della stringa che forma il segnalibro in base al suo nome.
GetCharParamsFornisce accesso ai parametri di un singolo carattere.
GetDropCapCharParamsFornisce accesso ai parametri del capolettera di un paragrafo.
GetHyperlinkRangeAnalizza un singolo carattere di collegamento ipertestuale e individua l’indice del carattere iniziale e la lunghezza della stringa che forma il collegamento ipertestuale.
GetWordRecognitionVariantsRestituisce una raccolta di varianti del riconoscimento di una parola nella posizione corrente all’interno del testo di un paragrafo.
InsertInserisce una stringa nel testo del paragrafo.
InsertParagraphBreakDivide il paragrafo in due parti.
InsertTabInserisce un tab stop nella posizione di testo selezionata.
InsertTextInserisce il testo specificato nel testo del paragrafo.
NextGroupTrova il carattere successivo nel paragrafo per cui i parametri selezionati differiscono da quelli del carattere con cui ha inizio la ricerca. Questo metodo può essere usato per trovare tutte le parole in grassetto o in corsivo nel paragrafo, tutti i caratteri riconosciuti con incertezza, ecc.
RangeRestituisce una sottostringa dal testo del paragrafo.
RemoveElimina un intervallo dal testo del paragrafo.
SetBookmarkImposta un segnalibro utente su una stringa all’interno di un paragrafo.
SetCharParamsImposta i parametri per un gruppo di caratteri.
SetHyperlinkImposta un collegamento ipertestuale su una stringa all’interno di un paragrafo.
Paragraph Diagramma degli oggetti

​
Parametro di output

Questo oggetto è il parametro di output dei seguenti metodi:

​
Parametro di input

Questo oggetto è il parametro di input del metodo IndexOf dell’oggetto Paragraphs.

​
Esempi

FREngine.IBlock block;
int suspiciousCharsCount = 0;
// Itera i paragrafi di un blocco di testo e calcola il numero di caratteri sospetti
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;
 FREngine.ICharParams charParams = engine.CreateCharParams();
 for (int iChar = 0; iChar < text.Length; iChar++)
 {
  par.GetCharParams(iChar, charParams);
  if (charParams.IsSuspicious)
  {
   suspiciousCharsCount++;
  }
 }
}
L’oggetto viene utilizzato nei seguenti esempi di codice:

​
Vedere anche

Paragraphs Working with Text Working with Properties