Paragraph

Paragraph class

Representerar ett textstycke.

För att lära dig mer, besökArbeta med paragrafer dokumentationsartikel.

public class Paragraph : CompositeNode

Konstruktörer

namnBeskrivning
Paragraph(DocumentBase)Initierar en ny instans avParagraph class.

Egenskaper

namnBeskrivning
BreakIsStyleSeparator { get; }Sant om denna styckebrytning är en stilavskiljare. En stilavgränsare tillåter one stycke att bestå av delar som har olika styckestilar.
Count { get; }Hämtar antalet omedelbara barn till denna nod.
CustomNodeId { get; set; }Anger anpassad nodidentifierare.
virtual Document { get; }Hämtar dokumentet som denna nod tillhör.
FirstChild { get; }Får det första barnet i noden.
FrameFormat { get; }Ger tillgång till ramformateringsegenskaperna.
HasChildNodes { get; }ReturnerarSann om denna nod har några undernoder.
override IsComposite { get; }ReturnerarSann eftersom denna nod kan ha underordnade noder.
IsDeleteRevision { get; }Returnerar sant om detta objekt raderades i Microsoft Word medan ändringsspårning var aktiverad.
IsEndOfCell { get; }Sant om detta stycke är det sista stycket i enCell ; falskt annars.
IsEndOfDocument { get; }Sant om detta stycke är det sista stycket i den sista delen av dokumentet.
IsEndOfHeaderFooter { get; }Sant om detta stycke är det sista stycket iHeaderFooter (huvudtextberättelse) av enSection ; falskt annars.
IsEndOfSection { get; }Sant om detta stycke är det sista stycket iBody (huvudtextberättelse) av enSection ; falskt annars.
IsFormatRevision { get; }Returnerar sant om formateringen av objektet ändrades i Microsoft Word medan ändringsspårning var aktiverad.
IsInCell { get; }Sant om det här stycket är ett omedelbart barn tillCell ; falskt annars.
IsInsertRevision { get; }Returnerar sant om det här objektet infogades i Microsoft Word medan ändringsspårning var aktiverad.
IsListItem { get; }Sant när stycket är ett objekt i en punktlista eller numrerad lista i originalversionen.
IsMoveFromRevision { get; }ReturnerarSann om det här objektet flyttades (borttogs) i Microsoft Word medan ändringsspårning var aktiverad.
IsMoveToRevision { get; }ReturnerarSann om detta objekt flyttades (infogades) i Microsoft Word medan ändringsspårning var aktiverad.
LastChild { get; }Hämtar nodens sista underordnade.
ListFormat { get; }Ger tillgång till listformateringsegenskaperna för stycket.
ListLabel { get; }Får enListLabelobjekt som ger tillgång till listnumreringsvärde och formatering för detta stycke.
NextSibling { get; }Hämtar noden omedelbart efter denna nod.
override NodeType { get; }ReturnerarParagraph .
ParagraphBreakFont { get; }Ger tillgång till teckensnittsformateringen för styckebrytningstecknet.
ParagraphFormat { get; }Ger tillgång till styckeformateringsegenskaperna.
ParentNode { get; }Hämtar den omedelbara föräldern till denna nod.
ParentSection { get; }Hämtar föräldernSection i stycket.
ParentStory { get; }Hämtar den överordnade berättelsen på sektionsnivå som kan varaBody ellerHeaderFooter .
PreviousSibling { get; }Hämtar noden omedelbart före denna nod.
Range { get; }Returnerar enRange objekt som representerar den del av ett dokument som finns i denna nod.
Runs { get; }Ger tillgång till den maskinskrivna samlingen av textbitar i stycket.

Metoder

namnBeskrivning
override Accept(DocumentVisitor)Accepterar en besökare.
AppendChild(Node)Lägger till den angivna noden i slutet av listan över underordnade noder för denna nod.
AppendField(string)Lägger till ett fält i detta stycke.
AppendField(FieldType, bool)Lägger till ett fält i detta stycke.
AppendField(string, string)Lägger till ett fält i detta stycke.
Clone(bool)Skapar en dubblett av noden.
CreateNavigator()Skapar navigator som kan användas för att korsa och läsa noder.
GetAncestor(NodeType)Hämtar den första förfadern till den angivnaNodeType .
GetAncestor(Type)Hämtar den första förfadern till den angivna objekttypen.
GetChild(NodeType, int, bool)Returnerar en N:te underordnad nod som matchar den angivna typen.
GetChildNodes(NodeType, bool)Returnerar en aktiv samling av underordnade noder som matchar den angivna typen.
GetEffectiveTabStops()Returnerar array av alla tabbstopp som tillämpas på detta stycke, inklusive applicerade indirekt av stilar eller listor.
GetEnumerator()Tillhandahåller stöd för varje stiliteration över undernoderna för denna nod.
override GetText()Hämtar texten i detta stycke inklusive slutet av styckets tecken.
IndexOf(Node)Returnerar indexet för den angivna undernoden i den underordnade nodmatrisen.
InsertAfter(NodeNode)Infogar den angivna noden omedelbart efter den angivna referensnoden.
InsertBefore(NodeNode)Infogar den angivna noden omedelbart före den angivna referensnoden.
InsertField(string, Node, bool)Infogar ett fält i detta stycke.
InsertField(FieldType, bool, Node, bool)Infogar ett fält i detta stycke.
InsertField(string, string, Node, bool)Infogar ett fält i detta stycke.
JoinRunsWithSameFormatting()Joins körs med samma formatering i stycket.
NextPreOrder(Node)Hämtar nästa nod enligt algoritmen för förbeställningsträdet.
PrependChild(Node)Lägger till den angivna noden i början av listan över underordnade noder för denna nod.
PreviousPreOrder(Node)Hämtar föregående nod enligt algoritmen för förbeställningsträdet.
Remove()Tar bort sig själv från föräldern.
RemoveAllChildren()Tar bort alla undernoder för den aktuella noden.
RemoveChild(Node)Tar bort den angivna underordnade noden.
RemoveSmartTags()Tar bort allaSmartTagunderliggande noder till den aktuella noden.
SelectNodes(string)Väljer en lista med noder som matchar XPath-uttrycket.
SelectSingleNode(string)Väljer den förstaNode som matchar XPath-uttrycket.
ToString(SaveFormat)Exporterar innehållet i noden till en sträng i angivet format.
ToString(SaveOptions)Exporterar innehållet i noden till en sträng med de angivna sparalternativen.

Anmärkningar

Paragraph är en nod på blocknivå och kan vara ett barn av klasser härledda från Story ellerInlineStory.

Paragraph kan innehålla valfritt antal noder och bokmärken på inline-nivå.

Den fullständiga listan över underordnade noder som kan förekomma i ett stycke består av BookmarkStart ,BookmarkEnd , FieldStart ,FieldSeparator , FieldEnd ,FormField , Comment ,Footnote , Run ,SpecialChar , Shape ,GroupShape , SmartTag.

Ett giltigt stycke i Microsoft Word slutar alltid med ett styckebrytningstecken och ett minimalt giltigt stycke består bara av en styckebrytning. DeParagraph Klassen lägger automatiskt till lämpligt styckebrytningstecken i slutet och detta tecken är inte en del av undernoderna iParagraph , därför aParagraph kan vara tom.

Inkludera inte slutet av stycketParagraphBreak eller slutet av cellenCell tecken i texten i stycket eftersom det kan göra stycket ogiltigt när dokumentet öppnas i Microsoft Word.

Exempel

Visar hur man konstruerar ett Aspose.Words-dokument för hand.

Document doc = new Document();

// Ett tomt dokument innehåller ett avsnitt, en brödtext och ett stycke.
// Anropa metoden "RemoveAllChildren" för att ta bort alla dessa noder,
// och slutar med en dokumentnod utan underordnade.
doc.RemoveAllChildren();

// Det här dokumentet har nu inga sammansatta underordnade noder som vi kan lägga till innehåll till.
// Om vi vill redigera den måste vi fylla på dess nodsamling.
// Skapa först ett nytt avsnitt och lägg sedan till det som ett underordnat dokument i rotdokumentnoden.
Section section = new Section(doc);
doc.AppendChild(section);

// Ställ in några sidinställningar för avsnittet.
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;

// En sektion behöver en kropp som kommer att innehålla och visa allt dess innehåll
// på sidan mellan avsnittets sidhuvud och sidfot.
Body body = new Body(doc);
section.AppendChild(body);

// Skapa ett stycke, ange några formateringsegenskaper och lägg sedan till det som ett underordnat stycke i brödtexten.
Paragraph para = new Paragraph(doc);

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

body.AppendChild(para);

// Slutligen, lägg till lite innehåll för att göra dokumentet. Skapa en löprunda,
// ställ in dess utseende och innehåll och lägg sedan till det som ett barn till stycket.
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");

Se även