Paragraph
Innehåll
[
Dölj
]Paragraph class
Representerar ett textstycke.
För att lära dig mer, besökArbeta med stycken dokumentationsartikel.
public class Paragraph : CompositeNode
Konstruktörer
| namn | Beskrivning |
|---|---|
| Paragraph(DocumentBase) | Initierar en ny instans avParagraph klass. |
Egenskaper
| namn | Beskrivning |
|---|---|
| BreakIsStyleSeparator { get; } | Sant om denna styckebrytning är en stilseparator. En stilseparator gör att ett stycke kan 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; } | Hämtar nodens första barn. |
| FrameFormat { get; } | Ger åtkomst till egenskaperna för ramformatering. |
| HasChildNodes { get; } | Returersann om den här noden har några undernoder. |
| override IsComposite { get; } | Returersann eftersom denna nod kan ha underordnade noder. |
| IsDeleteRevision { get; } | Returnerar sant om det här objektet togs bort 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 dokumentets sista avsnitt. |
| 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 objektets formatering ändrades i Microsoft Word medan ändringsspårning var aktiverad. |
| IsInCell { get; } | Sant om detta stycke är ett direkt underordnat stycke 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 den ursprungliga versionen. |
| IsMoveFromRevision { get; } | Returersann om det här objektet flyttades (raderades) i Microsoft Word medan ändringsspårning var aktiverad. |
| IsMoveToRevision { get; } | Returersann om det här objektet flyttades (infogades) i Microsoft Word medan ändringsspårning var aktiverad. |
| LastChild { get; } | Hämtar nodens sista barn. |
| ListFormat { get; } | Ger åtkomst till listformateringsegenskaperna för stycket. |
| ListLabel { get; } | Får enListLabelobjekt som ger åtkomst till listnumreringsvärde och formatering för detta stycke. |
| NextSibling { get; } | Hämtar noden som följer direkt efter denna nod. |
| override NodeType { get; } | ReturerParagraph . |
| ParagraphBreakFont { get; } | Ger åtkomst till teckensnittsformateringen för styckebrytningstecknet. |
| ParagraphFormat { get; } | Ger åtkomst till styckeformateringsegenskaperna. |
| ParentNode { get; } | Hämtar den omedelbara föräldern till denna nod. |
| ParentSection { get; } | Hämtar föräldernSection av stycket. |
| ParentStory { get; } | Hämtar den överordnade artikeln på sektionsnivå som kan varaBody ellerHeaderFooter . |
| PreviousSibling { get; } | Hämtar noden som omedelbart föregår denna nod. |
| Range { get; } | Returnerar enRangeobjekt som representerar den del av ett dokument som finns i denna nod. |
| Runs { get; } | Ger åtkomst till den maskinskrivna samlingen av textbitar inuti stycket. |
Metoder
| namn | Beskrivning |
|---|---|
| override Accept(DocumentVisitor) | Tar emot en besökare. |
| override AcceptEnd(DocumentVisitor) | Accepterar en besökare för att besöka slutet av dokumentets stycke. |
| override AcceptStart(DocumentVisitor) | Accepterar en besökare för att besöka början av dokumentets stycke. |
| AppendChild<T>(T) | 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 duplikat av noden. |
| CreateNavigator() | Skapar en 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 live-samling av underordnade noder som matchar den angivna typen. |
| GetEffectiveTabStops() | Returnerar en matris med alla tabbstopp som tillämpats på detta stycke, inklusive indirekt tillämpade av format eller listor. |
| GetEnumerator() | Ger stöd för iterationen för varje stil över de underordnade noderna till denna nod. |
| override GetText() | Hämtar texten i detta stycke inklusive slutet av stycket. |
| IndexOf(Node) | Returnerar indexet för den angivna undernoden i undernodsmatrisen. |
| InsertAfter<T>(T, Node) | Infogar den angivna noden omedelbart efter den angivna referensnoden. |
| InsertBefore<T>(T, Node) | 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() | Kopplar samman körningar med samma formatering i stycket. |
| NextPreOrder(Node) | Hämtar nästa nod enligt algoritmen för förbeställningsträdtraversering. |
| PrependChild<T>(T) | 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 trädtraversering i förbeställning. |
| Remove() | Tar bort sig själv från föräldern. |
| RemoveAllChildren() | Tar bort alla undernoder till den aktuella noden. |
| RemoveChild<T>(T) | Tar bort den angivna undernoden. |
| RemoveSmartTags() | Tar bort allaSmartTag underordnade 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 nodens innehåll till en sträng i det angivna formatet. |
| ToString(SaveOptions) | Exporterar nodens innehåll till en sträng med de angivna sparalternativen. |
Anmärkningar
Paragraph är en blocknivånod och kan vara ett barn till klasser härledda från Story ellerInlineStory.
Paragraph kan innehålla valfritt antal noder och bokmärken på inline-nivå.
Den kompletta listan över underordnade noder som kan förekomma inuti ett stycke består av BookmarkStart ,BookmarkEnd , FieldStart ,FieldSeparator , FieldEnd ,FormField , Comment ,Footnote , Run ,SpecialChar , Shape ,GroupShape , SmartTag.
Ett giltigt stycke i Microsoft Word avslutas alltid med ett styckebrytningstecken och ett minimalt giltigt stycke består bara av en styckebrytning.Paragraph Klassen lägger automatiskt till lämpligt styckebrytningstecken i slutet av och detta tecken är inte en del av undernoderna tillParagraph , därför aParagraph kan vara tom.
Inkludera inte slutet av stycketParagraphBreak eller slutet av cellenCell tecken inuti 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 barn.
doc.RemoveAllChildren();
// Det här dokumentet har nu inga sammansatta undernoder som vi kan lägga till innehåll till.
// Om vi vill redigera den måste vi fylla i dess nodsamling igen.
// Skapa först en ny sektion och lägg sedan till den som ett underordnat avsnitt till rotdokumentnoden.
Section section = new Section(doc);
doc.AppendChild(section);
// Ange vissa sidinställningar för avsnittet.
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;
// En sektion behöver en brödtext, som innehåller och visar 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 körning,
// ange dess utseende och innehåll och lägg sedan till det som ett underordnat stycke.
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
- class CompositeNode
- namnutrymme Aspose.Words
- hopsättning Aspose.Words
