Paragraph

Paragraph class

Rappresenta un paragrafo di testo.

Per saperne di più, visita ilLavorare con i paragrafi articolo di documentazione.

public class Paragraph : CompositeNode

Costruttori

NomeDescrizione
Paragraph(DocumentBase)Inizializza una nuova istanza diParagraph classe.

Proprietà

NomeDescrizione
BreakIsStyleSeparator { get; }Vero se questa interruzione di paragrafo è un separatore di stile. Un separatore di stile consente a un paragrafo di essere composto da parti con stili di paragrafo diversi.
Count { get; }Ottiene il numero di figli immediati di questo nodo.
CustomNodeId { get; set; }Specifica l’identificatore del nodo personalizzato.
virtual Document { get; }Ottiene il documento a cui appartiene questo nodo.
FirstChild { get; }Ottiene il primo figlio del nodo.
FrameFormat { get; }Fornisce accesso alle proprietà di formattazione del frame.
HasChildNodes { get; }RestituisceVERO se questo nodo ha nodi figlio.
override IsComposite { get; }RestituisceVERO poiché questo nodo può avere nodi figlio.
IsDeleteRevision { get; }Restituisce true se questo oggetto è stato eliminato in Microsoft Word mentre il monitoraggio delle modifiche era abilitato.
IsEndOfCell { get; }Vero se questo paragrafo è l’ultimo paragrafo di unCell ; falso altrimenti.
IsEndOfDocument { get; }Vero se questo paragrafo è l’ultimo paragrafo nell’ultima sezione del documento.
IsEndOfHeaderFooter { get; }Vero se questo paragrafo è l’ultimo paragrafo nelHeaderFooter (testo principale della storia) di unSection ; falso altrimenti.
IsEndOfSection { get; }Vero se questo paragrafo è l’ultimo paragrafo nelBody (testo principale della storia) di unSection ; falso altrimenti.
IsFormatRevision { get; }Restituisce true se la formattazione dell’oggetto è stata modificata in Microsoft Word mentre il rilevamento delle modifiche era abilitato.
IsInCell { get; }Vero se questo paragrafo è un figlio immediato diCell ; falso altrimenti.
IsInsertRevision { get; }Restituisce true se questo oggetto è stato inserito in Microsoft Word mentre il rilevamento delle modifiche era abilitato.
IsListItem { get; }Vero quando il paragrafo è un elemento in un elenco puntato o numerato nella revisione originale.
IsMoveFromRevision { get; }RestituisceVERO se questo oggetto è stato spostato (eliminato) in Microsoft Word mentre il monitoraggio delle modifiche era abilitato.
IsMoveToRevision { get; }RestituisceVERO se questo oggetto è stato spostato (inserito) in Microsoft Word mentre il monitoraggio delle modifiche era abilitato.
LastChild { get; }Ottiene l’ultimo figlio del nodo.
ListFormat { get; }Fornisce accesso alle proprietà di formattazione dell’elenco del paragrafo.
ListLabel { get; }Ottiene unListLabeloggetto che fornisce l’accesso al valore di numerazione e formattazione dell’elenco per questo paragrafo.
NextSibling { get; }Ottiene il nodo immediatamente successivo a questo nodo.
override NodeType { get; }RestituisceParagraph .
ParagraphBreakFont { get; }Fornisce accesso alla formattazione del carattere di interruzione di paragrafo.
ParagraphFormat { get; }Fornisce accesso alle proprietà di formattazione del paragrafo.
ParentNode { get; }Ottiene il genitore immediato di questo nodo.
ParentSection { get; }Recupera il genitoreSection del paragrafo.
ParentStory { get; }Recupera la storia a livello di sezione padre che può essereBody OHeaderFooter .
PreviousSibling { get; }Ottiene il nodo immediatamente precedente questo nodo.
Range { get; }Restituisce unRangeoggetto che rappresenta la porzione di un documento contenuta in questo nodo.
Runs { get; }Fornisce l’accesso alla raccolta di testi digitati all’interno del paragrafo.

Metodi

NomeDescrizione
override Accept(DocumentVisitor)Accetta un visitatore.
override AcceptEnd(DocumentVisitor)Accetta un visitatore per aver visitato la fine del paragrafo del documento.
override AcceptStart(DocumentVisitor)Accetta un visitatore per aver visitato l’inizio del paragrafo del documento.
AppendChild<T>(T)Aggiunge il nodo specificato alla fine dell’elenco dei nodi figlio per questo nodo.
AppendField(string)Aggiunge un campo a questo paragrafo.
AppendField(FieldType, bool)Aggiunge un campo a questo paragrafo.
AppendField(string, string)Aggiunge un campo a questo paragrafo.
Clone(bool)Crea un duplicato del nodo.
CreateNavigator()Crea un navigatore che può essere utilizzato per attraversare e leggere i nodi.
GetAncestor(NodeType)Ottiene il primo antenato dell’oggetto specificatoNodeType .
GetAncestor(Type)Ottiene il primo antenato del tipo di oggetto specificato.
GetChild(NodeType, int, bool)Restituisce un N-esimo nodo figlio che corrisponde al tipo specificato.
GetChildNodes(NodeType, bool)Restituisce una raccolta live di nodi figlio che corrispondono al tipo specificato.
GetEffectiveTabStops()Restituisce una matrice di tutte le tabulazioni applicate a questo paragrafo, comprese quelle applicate indirettamente da stili o elenchi.
GetEnumerator()Fornisce supporto per ogni iterazione di stile sui nodi figlio di questo nodo.
override GetText()Ottiene il testo di questo paragrafo, incluso il carattere di fine paragrafo.
IndexOf(Node)Restituisce l’indice del nodo figlio specificato nell’array dei nodi figlio.
InsertAfter<T>(T, Node)Inserisce il nodo specificato subito dopo il nodo di riferimento specificato.
InsertBefore<T>(T, Node)Inserisce il nodo specificato immediatamente prima del nodo di riferimento specificato.
InsertField(string, Node, bool)Inserisce un campo in questo paragrafo.
InsertField(FieldType, bool, Node, bool)Inserisce un campo in questo paragrafo.
InsertField(string, string, Node, bool)Inserisce un campo in questo paragrafo.
JoinRunsWithSameFormatting()Unisce le esecuzioni con la stessa formattazione nel paragrafo.
NextPreOrder(Node)Ottiene il nodo successivo in base all’algoritmo di attraversamento dell’albero preordinato.
PrependChild<T>(T)Aggiunge il nodo specificato all’inizio dell’elenco dei nodi figlio per questo nodo.
PreviousPreOrder(Node)Ottiene il nodo precedente secondo l’algoritmo di attraversamento dell’albero preordinato.
Remove()Si rimuove dal genitore.
RemoveAllChildren()Rimuove tutti i nodi figlio del nodo corrente.
RemoveChild<T>(T)Rimuove il nodo figlio specificato.
RemoveSmartTags()Rimuove tuttoSmartTag nodi discendenti del nodo corrente.
SelectNodes(string)Seleziona un elenco di nodi che corrispondono all’espressione XPath.
SelectSingleNode(string)Seleziona il primoNode che corrisponde all’espressione XPath.
ToString(SaveFormat)Esporta il contenuto del nodo in una stringa nel formato specificato.
ToString(SaveOptions)Esporta il contenuto del nodo in una stringa utilizzando le opzioni di salvataggio specificate.

Osservazioni

Paragraph è un nodo a livello di blocco e può essere un figlio di classi derivate da Story OInlineStory.

Paragraph può contenere un numero qualsiasi di nodi e segnalibri in linea.

L’elenco completo dei nodi figlio che possono verificarsi all’interno di un paragrafo è costituito da BookmarkStart ,BookmarkEnd , FieldStart ,FieldSeparator , FieldEnd ,FormField , Comment ,Footnote , Run ,SpecialChar , Shape ,GroupShape , SmartTag.

Un paragrafo valido in Microsoft Word termina sempre con un carattere di interruzione di paragrafo e un paragrafo minimo valido consiste solo in un’interruzione di paragrafo.Paragraph La classe aggiunge automaticamente il carattere di interruzione di paragrafo appropriato alla fine di e questo carattere non fa parte dei nodi figlio delParagraph , quindi aParagraph può essere vuoto.

Non includere la fine del paragrafoParagraphBreak o fine della cellaCell caratteri all’interno del testo di del paragrafo, poiché potrebbero rendere il paragrafo non valido quando il documento viene aperto in Microsoft Word.

Esempi

Mostra come creare manualmente un documento Aspose.Words.

Document doc = new Document();

// Un documento vuoto contiene una sezione, un corpo e un paragrafo.
// Chiama il metodo "RemoveAllChildren" per rimuovere tutti quei nodi,
// e si finisce con un nodo documento senza elementi figlio.
doc.RemoveAllChildren();

// Questo documento non ha più nodi figlio compositi a cui aggiungere contenuto.
// Se volessimo modificarlo, dovremo ripopolare la sua raccolta di nodi.
// Per prima cosa, crea una nuova sezione, quindi aggiungila come figlia al nodo radice del documento.
Section section = new Section(doc);
doc.AppendChild(section);

// Imposta alcune proprietà di impostazione della pagina per la sezione.
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;

// Una sezione ha bisogno di un corpo, che conterrà e visualizzerà tutto il suo contenuto
// nella pagina tra l'intestazione e il piè di pagina della sezione.
Body body = new Body(doc);
section.AppendChild(body);

// Crea un paragrafo, imposta alcune proprietà di formattazione e poi aggiungilo come elemento secondario al corpo.
Paragraph para = new Paragraph(doc);

para.ParagraphFormat.StyleName = "Heading 1";
para.ParagraphFormat.Alignment = ParagraphAlignment.Center;

body.AppendChild(para);

// Infine, aggiungi del contenuto per completare il documento. Crea una run,
// impostane l'aspetto e il contenuto, quindi aggiungilo come elemento figlio al paragrafo.
Run run = new Run(doc);
run.Text = "Hello World!";
run.Font.Color = Color.Red;
para.AppendChild(run);

Assert.AreEqual("Hello World!", doc.GetText().Trim());

doc.Save(ArtifactsDir + "Section.CreateManually.docx");

Guarda anche