Paragraph
Inhalt
[
Ausblenden
]Paragraph class
Stellt einen Textabsatz dar.
Um mehr zu erfahren, besuchen Sie dieArbeiten mit Absätzen Dokumentationsartikel.
public class Paragraph : CompositeNode
Konstrukteure
| Name | Beschreibung |
|---|---|
| Paragraph(DocumentBase) | Initialisiert eine neue Instanz vonParagraph Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| BreakIsStyleSeparator { get; } | True, wenn dieser Absatzumbruch ein Stiltrennzeichen ist. Ein Stiltrennzeichen ermöglicht, dass ein Absatz aus Teilen mit unterschiedlichen Absatzstilen bestehen kann. |
| Count { get; } | Ruft die Anzahl der unmittelbaren Kinder dieses Knotens ab. |
| CustomNodeId { get; set; } | Gibt die benutzerdefinierte Knotenkennung an. |
| virtual Document { get; } | Ruft das Dokument ab, zu dem dieser Knoten gehört. |
| FirstChild { get; } | Ruft das erste untergeordnete Element des Knotens ab. |
| FrameFormat { get; } | Bietet Zugriff auf die Frame-Formatierungseigenschaften. |
| HasChildNodes { get; } | Gibt zurückWAHR wenn dieser Knoten untergeordnete Knoten hat. |
| override IsComposite { get; } | Gibt zurückWAHR da dieser Knoten untergeordnete Knoten haben kann. |
| IsDeleteRevision { get; } | Gibt „true“ zurück, wenn dieses Objekt in Microsoft Word gelöscht wurde, während die Änderungsverfolgung aktiviert war. |
| IsEndOfCell { get; } | True, wenn dieser Absatz der letzte Absatz in a istCell ; sonst falsch. |
| IsEndOfDocument { get; } | True, wenn dieser Absatz der letzte Absatz im letzten Abschnitt des Dokuments ist. |
| IsEndOfHeaderFooter { get; } | True, wenn dieser Absatz der letzte Absatz im istHeaderFooter (Haupttextgeschichte) von aSection ; sonst falsch. |
| IsEndOfSection { get; } | True, wenn dieser Absatz der letzte Absatz im istBody (Haupttextgeschichte) von aSection ; sonst falsch. |
| IsFormatRevision { get; } | Gibt „true“ zurück, wenn die Formatierung des Objekts in Microsoft Word geändert wurde, während die Änderungsverfolgung aktiviert war. |
| IsInCell { get; } | True, wenn dieser Absatz ein unmittelbares untergeordnetes Element von istCell ; sonst falsch. |
| IsInsertRevision { get; } | Gibt „true“ zurück, wenn dieses Objekt in Microsoft Word eingefügt wurde, während die Änderungsverfolgung aktiviert war. |
| IsListItem { get; } | True, wenn der Absatz ein Element in einer Liste mit Aufzählungszeichen oder Nummern in der Originalrevision ist. |
| IsMoveFromRevision { get; } | Gibt zurückWAHR wenn dieses Objekt in Microsoft Word verschoben (gelöscht) wurde, während die Änderungsverfolgung aktiviert war. |
| IsMoveToRevision { get; } | Gibt zurückWAHR wenn dieses Objekt in Microsoft Word verschoben (eingefügt) wurde, während die Änderungsverfolgung aktiviert war. |
| LastChild { get; } | Ruft das letzte untergeordnete Element des Knotens ab. |
| ListFormat { get; } | Bietet Zugriff auf die Listenformatierungseigenschaften des Absatzes. |
| ListLabel { get; } | Ruft a abListLabelObjekt, das Zugriff auf den Listennummerierungswert und die Formatierung für diesen Absatz bietet. |
| NextSibling { get; } | Ruft den Knoten ab, der diesem Knoten unmittelbar folgt. |
| override NodeType { get; } | Gibt zurückParagraph . |
| ParagraphBreakFont { get; } | Bietet Zugriff auf die Schriftartformatierung des Absatzumbruchzeichens. |
| ParagraphFormat { get; } | Bietet Zugriff auf die Absatzformatierungseigenschaften. |
| ParentNode { get; } | Ruft das unmittelbare übergeordnete Element dieses Knotens ab. |
| ParentSection { get; } | Ruft das übergeordnete Element abSection des Absatzes. |
| ParentStory { get; } | Ruft die übergeordnete Story auf Abschnittsebene ab, die sein kannBody oderHeaderFooter . |
| PreviousSibling { get; } | Ruft den Knoten ab, der diesem Knoten unmittelbar vorangeht. |
| Range { get; } | Gibt a zurückRange Objekt, das den Teil eines Dokuments darstellt, der in diesem Knoten enthalten ist. |
| Runs { get; } | Bietet Zugriff auf die eingegebene Sammlung von Textteilen im Absatz. |
Methoden
| Name | Beschreibung |
|---|---|
| override Accept(DocumentVisitor) | Akzeptiert einen Besucher. |
| AppendChild(Node) | Fügt den angegebenen Knoten am Ende der Liste der untergeordneten Knoten für diesen Knoten hinzu. |
| AppendField(string) | Fügt ein Feld an diesen Absatz an. |
| AppendField(FieldType, bool) | Fügt ein Feld an diesen Absatz an. |
| AppendField(string, string) | Fügt ein Feld an diesen Absatz an. |
| Clone(bool) | Erstellt ein Duplikat des Knotens. |
| CreateNavigator() | Erstellt einen Navigator, der zum Durchlaufen und Lesen von Knoten verwendet werden kann. |
| GetAncestor(NodeType) | Ruft den ersten Vorfahren des angegebenen abNodeType . |
| GetAncestor(Type) | Ruft den ersten Vorfahren des angegebenen Objekttyps ab. |
| GetChild(NodeType, int, bool) | Gibt einen N-ten untergeordneten Knoten zurück, der dem angegebenen Typ entspricht. |
| GetChildNodes(NodeType, bool) | Gibt eine Live-Sammlung untergeordneter Knoten zurück, die dem angegebenen Typ entsprechen. |
| GetEffectiveTabStops() | Gibt ein Array aller Tabstopps zurück, die auf diesen Absatz angewendet werden, einschließlich indirekter Tabstopps durch Stile oder Listen. |
| GetEnumerator() | Bietet Unterstützung für die Iteration jedes Stils über die untergeordneten Knoten dieses Knotens. |
| override GetText() | Ruft den Text dieses Absatzes einschließlich des Absatzendezeichens ab. |
| IndexOf(Node) | Gibt den Index des angegebenen untergeordneten Knotens im untergeordneten Knoten-Array zurück. |
| InsertAfter(Node, Node) | Fügt den angegebenen Knoten unmittelbar nach dem angegebenen Referenzknoten ein. |
| InsertBefore(Node, Node) | Fügt den angegebenen Knoten unmittelbar vor dem angegebenen Referenzknoten ein. |
| InsertField(string, Node, bool) | Fügt ein Feld in diesen Absatz ein. |
| InsertField(FieldType, bool, Node, bool) | Fügt ein Feld in diesen Absatz ein. |
| InsertField(string, string, Node, bool) | Fügt ein Feld in diesen Absatz ein. |
| JoinRunsWithSameFormatting() | Joins werden mit der gleichen Formatierung im Absatz ausgeführt. |
| NextPreOrder(Node) | Ruft den nächsten Knoten gemäß dem Pre-Order-Tree-Traversal-Algorithmus ab. |
| PrependChild(Node) | Fügt den angegebenen Knoten am Anfang der Liste der untergeordneten Knoten für diesen Knoten hinzu. |
| PreviousPreOrder(Node) | Ruft den vorherigen Knoten gemäß dem Pre-Order-Tree-Traversal-Algorithmus ab. |
| Remove() | Entfernt sich selbst vom übergeordneten Element. |
| RemoveAllChildren() | Entfernt alle untergeordneten Knoten des aktuellen Knotens. |
| RemoveChild(Node) | Entfernt den angegebenen untergeordneten Knoten. |
| RemoveSmartTags() | Entfernt alleSmartTagNachkommenknoten des aktuellen Knotens. |
| SelectNodes(string) | Wählt eine Liste von Knoten aus, die dem XPath-Ausdruck entsprechen. |
| SelectSingleNode(string) | Wählt den ersten ausNode das entspricht dem XPath-Ausdruck. |
| ToString(SaveFormat) | Exportiert den Inhalt des Knotens in einen String im angegebenen Format. |
| ToString(SaveOptions) | Exportiert den Inhalt des Knotens mit den angegebenen Speicheroptionen in einen String. |
Bemerkungen
Paragraph ist ein Knoten auf Blockebene und kann ein untergeordnetes Element von Klassen sein, die von abgeleitet sind.Story oderInlineStory.
Paragraph kann eine beliebige Anzahl von Knoten und Lesezeichen auf Inline-Ebene enthalten.
Die vollständige Liste der untergeordneten Knoten, die innerhalb eines Absatzes vorkommen können, besteht aus BookmarkStart ,BookmarkEnd , FieldStart ,FieldSeparator , FieldEnd ,FormField , Comment ,Footnote , Run ,SpecialChar , Shape ,GroupShape , SmartTag.
Ein gültiger Absatz in Microsoft Word endet immer mit einem Absatzumbruchzeichen und ein minimaler gültiger Absatz besteht nur aus einem Absatzumbruch. DerParagraph Die Klasse hängt automatisch das entsprechende Absatzumbruchzeichen am Ende an und dieses Zeichen ist nicht Teil der untergeordneten Knoten der KlasseParagraph , also aParagraph kann leer sein.
Fügen Sie das Ende des Absatzes nicht einParagraphBreak oder Ende der ZelleCell Zeichen im Text von des Absatzes, da der Absatz dadurch möglicherweise ungültig wird, wenn das Dokument in Microsoft Word geöffnet wird.
Beispiele
Zeigt, wie man ein Aspose.Words-Dokument manuell erstellt.
Document doc = new Document();
// Ein leeres Dokument enthält einen Abschnitt, einen Hauptteil und einen Absatz.
// Rufen Sie die Methode „RemoveAllChildren“ auf, um alle diese Knoten zu entfernen.
// und erhalten am Ende einen Dokumentknoten ohne untergeordnete Elemente.
doc.RemoveAllChildren();
// Dieses Dokument hat jetzt keine zusammengesetzten untergeordneten Knoten, denen wir Inhalte hinzufügen können.
// Wenn wir es bearbeiten möchten, müssen wir seine Knotensammlung neu füllen.
// Erstellen Sie zunächst einen neuen Abschnitt und hängen Sie ihn dann als untergeordnetes Element an den Stammdokumentknoten an.
Section section = new Section(doc);
doc.AppendChild(section);
// Legen Sie einige Seiteneinrichtungseigenschaften für den Abschnitt fest.
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;
// Ein Abschnitt benötigt einen Hauptteil, der seinen gesamten Inhalt enthält und anzeigt
// auf der Seite zwischen Kopf- und Fußzeile des Abschnitts.
Body body = new Body(doc);
section.AppendChild(body);
// Einen Absatz erstellen, einige Formatierungseigenschaften festlegen und ihn dann als untergeordnetes Element an den Text anhängen.
Paragraph para = new Paragraph(doc);
para.ParagraphFormat.StyleName = "Heading 1";
para.ParagraphFormat.Alignment = ParagraphAlignment.Center;
body.AppendChild(para);
// Zum Schluss fügen Sie etwas Inhalt hinzu, um das Dokument zu erstellen. Erstellen Sie einen Lauf,
// Aussehen und Inhalt festlegen und dann als untergeordnetes Element an den Absatz anhängen.
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");
Siehe auch
- class CompositeNode
- namensraum Aspose.Words
- Montage Aspose.Words
