TextFragment

TextFragment class

Rappresenta un frammento di testo Pdf.

public class TextFragment : BaseParagraph

Costruttori

NomeDescrizione
TextFragment()Inizializza la nuova istanza diTextFragment oggetto.
TextFragment(string)CreaTextFragment oggetto con singoloTextSegment oggetto all’interno. Specifica la stringa di testo all’interno del segmento.
TextFragment(TabStops)Inizializza la nuova istanza diTextFragment oggetto con predefinitoTabStops posizioni.
TextFragment(string, TabStops)CreaTextFragment oggetto con singoloTextSegment oggetto all’interno e predefinitoTabStops posizioni.

Proprietà

NomeDescrizione
BaselinePosition { get; set; }Ottiene la posizione del testo per il testo, rappresentato conTextFragment oggetto. Il YIndent della struttura Posizione rappresenta la coordinata della linea di base del frammento di testo.
EndNote { get; set; }Ottiene o imposta la nota finale del paragrafo.(solo per la generazione di pdf)
FootNote { get; set; }Ottiene o imposta la nota a piè di pagina del paragrafo.(solo per la generazione di pdf)
Form { get; }Ottiene l’oggetto modulo che contiene TextFragment
override HorizontalAlignment { get; set; }Ottiene o imposta un allineamento orizzontale del frammento di testo.
override Hyperlink { set; }Imposta il collegamento ipertestuale del frammento
IsFirstParagraphInColumn { get; set; }Ottiene o imposta un valore bool che indica se questo paragrafo sarà nella colonna successiva. L’impostazione predefinita è false.(per la generazione di pdf)
IsInLineParagraph { get; set; }Ottiene o imposta un paragrafo in linea. L’impostazione predefinita è false.(per la generazione di pdf)
IsInNewPage { get; set; }Ottiene o imposta un valore bool che forza la generazione di questo paragrafo in una nuova pagina. L’impostazione predefinita è false.(per la generazione di pdf)
IsKeptWithNext { get; set; }Ottiene o imposta un valore bool che indica se il paragrafo corrente rimane nella stessa pagina insieme al paragrafo successivo. L’impostazione predefinita è false.(per la generazione di pdf)
Margin { get; set; }Ottiene o imposta un margine esterno per il paragrafo (per la generazione di pdf)
Page { get; }Ottiene la pagina che contiene TextFragment
Position { get; set; }Ottiene o imposta la posizione del testo per il testo, rappresentato conTextFragment oggetto.
Rectangle { get; }Ottiene il rettangolo di TextFragment
ReplaceOptions { get; }Ottiene le opzioni di sostituzione del testo. Le opzioni definiscono il comportamento quando il testo del frammento viene sostituito con più corto/lungo.
Segments { get; set; }Ottiene i segmenti di testo per la correnteTextFragment .
Text { get; set; }Ottiene o impostaString oggetto di testo che ilTextFragment l’oggetto rappresenta.
TextState { get; }Ottiene o imposta lo stato del testo per il testo cheTextFragment l’oggetto rappresenta.
override VerticalAlignment { get; set; }Ottiene o imposta un allineamento verticale del frammento di testo.
WrapLinesCount { get; set; }Ottiene o imposta il conteggio delle righe di avvolgimento per questo paragrafo (solo per la generazione di pdf)
ZIndex { get; set; }Ottiene o imposta un valore int che indica l’ordine Z del grafico. Un grafico con ZIndex più grande verrà posizionato sopra il grafico con ZIndex più piccolo. ZIndex può essere negativo. Il grafico con ZIndex negativo verrà posizionato dietro il testo nella pagina.

Metodi

NomeDescrizione
override Clone()Clona il frammento.
virtual CloneWithSegments()Clona il frammento con tutti i segmenti.
IsolateTextSegments(int, int)OttieneTextSegment (s) che rappresenta una parte specificata delTextFragment testo.

Osservazioni

In poche parole,TextFragment l’oggetto contiene un elenco diTextSegment oggetti. In dettaglio: Testo del documento pdf inPdf è rappresentato da due oggetti fondamentali:TextFragment eTextSegment Le differenze tra loro dipendono principalmente dal contesto. Consideriamo il seguente scenario. L’utente cerca il testo “ciao mondo” per operare con esso, cambiarne le proprietà, guardare ecc. La rappresentazione fisica del testo pdf è molto complessa. Il testo “ciao mondo” può essere costituito da diversi segmenti di testo fisicamente indipendenti. Il modello di testo Aspose.Pdf stabilisce sostanzialmente cheTextFragment object fornisce un’operazione logica singola impostata su fisicaTextSegment set di oggetti che rappresentano la query dell’utente. Nello scenario di ricerca di testo,TextFragment è la rappresentazione logica del testo “ciao mondo”, eTextSegmentla raccolta di oggetti rappresenta tutti i segmenti fisici che costruiscono l’oggetto di testo “hello world”. Quindi,TextFragment è vicino alla rappresentazione logica del testo. ETextSegment è vicino alla rappresentazione fisica del testo. Ovviamente ciascunoTextSegment l’oggetto può avere il proprio carattere, colorazione, proprietà di posizionamento. TextFragment fornisce un modo semplice per modificare il testo con le sue proprietà: imposta il carattere, imposta la dimensione del carattere, imposta il colore del carattere ecc. Nel frattempoTextSegment gli oggetti sono accessibili e gli utenti sono in grado di operareTextSegment oggetti in modo indipendente. Nota che la modifica delle proprietà di TextFragment può cambiareSegments raccolta perché TextFragment è un oggetto aggregato e può riorganizzare i segmenti interni o unirli in un singolo segmento. Se il tuo requisito è lasciare ilSegmentsraccolta invariata, cambia i segmenti interni individualmente.

Document doc = new Document(docFile);
TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");
doc.Pages[1].Accept(absorber);

Esempi

L’esempio mostra come trovare il testo nella prima pagina del documento PDF e sostituire il testo e il suo carattere.

// aggiungi un altro segmento alla raccolta Segments del frammento di testo
Document doc = new Document(@"D:\Tests\input.pdf");

// crea un oggetto TextBuilder
Aspose.Pdf.Txt.Font font = FontRepository.FindFont("Arial");

// aggiunge il frammento di testo alla pagina Pdf
TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");

//salva documento
doc.Pages[1].Accept(absorber);

// Apri documento
absorber.TextFragments[1].Text = "hi world";
absorber.TextFragments[1].TextState.Font = font;

// Trova il carattere che verrà utilizzato per modificare il carattere del testo del documento
doc.Save(@"D:\Tests\output.pdf");  

Guarda anche