Paragraph

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 desParagraph Klasse.

Eigenschaften

Name	Beschreibung
BreakIsStyleSeparator { get; }	Wahr, wenn dieser Absatzumbruch ein Stiltrennzeichen ist. Ein Stiltrennzeichen ermöglicht es, dass ein Absatz aus Teilen mit unterschiedlichen Absatzstilen besteht.
Count { get; }	Ruft die Anzahl der unmittelbar untergeordneten Elemente 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; }	RückgabenWAHR wenn dieser Knoten untergeordnete Knoten hat.
override IsComposite { get; }	RückgabenWAHR 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; }	Wahr, wenn dieser Absatz der letzte Absatz in einemCell ; andernfalls false.
IsEndOfDocument { get; }	Wahr, wenn dieser Absatz der letzte Absatz im letzten Abschnitt des Dokuments ist.
IsEndOfHeaderFooter { get; }	Wahr, wenn dieser Absatz der letzte Absatz in derHeaderFooter (Haupttextgeschichte) einesSection ; andernfalls false.
IsEndOfSection { get; }	Wahr, wenn dieser Absatz der letzte Absatz in derBody (Haupttextgeschichte) einesSection ; andernfalls false.
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; }	Wahr, wenn dieser Absatz ein unmittelbares Kind vonCell ; andernfalls false.
IsInsertRevision { get; }	Gibt „true“ zurück, wenn dieses Objekt in Microsoft Word eingefügt wurde, während die Änderungsverfolgung aktiviert war.
IsListItem { get; }	Wahr, wenn der Absatz ein Element in einer Aufzählungs- oder nummerierten Liste in der Originalrevision ist.
IsMoveFromRevision { get; }	RückgabenWAHR wenn dieses Objekt in Microsoft Word verschoben (gelöscht) wurde, während die Änderungsverfolgung aktiviert war.
IsMoveToRevision { get; }	RückgabenWAHR 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; }	Erhält eineListLabelObjekt, 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; }	RückgabenParagraph .
ParagraphBreakFont { get; }	Bietet Zugriff auf die Schriftformatierung des Absatzumbruchzeichens.
ParagraphFormat { get; }	Bietet Zugriff auf die Absatzformatierungseigenschaften.
ParentNode { get; }	Ruft den unmittelbar übergeordneten Knoten dieses Knotens ab.
ParentSection { get; }	Ruft das übergeordnete Element abSection des Absatzes.
ParentStory { get; }	Ruft die übergeordnete Story auf Abschnittsebene ab, dieBody oderHeaderFooter .
PreviousSibling { get; }	Ruft den Knoten ab, der diesem Knoten unmittelbar vorausgeht.
Range { get; }	Gibt einenRangeObjekt, das den Teil eines Dokuments darstellt, der in diesem Knoten enthalten ist.
Runs { get; }	Bietet Zugriff auf die eingegebene Sammlung von Textteilen innerhalb des Absatzes.

Methoden

Name	Beschreibung
override Accept(DocumentVisitor)	Nimmt einen Besucher auf.
override AcceptEnd(DocumentVisitor)	Akzeptiert einen Besucher, der das Ende des Absatzes des Dokuments besucht.
override AcceptStart(DocumentVisitor)	Akzeptiert einen Besucher, der den Anfang des Absatzes des Dokuments besucht.
AppendChild<T>(T)	Fügt den angegebenen Knoten am Ende der Liste der untergeordneten Knoten für diesen Knoten hinzu.
AppendField(string)	Fügt diesem Absatz ein Feld hinzu.
AppendField(FieldType, bool)	Fügt diesem Absatz ein Feld hinzu.
AppendField(string, string)	Fügt diesem Absatz ein Feld hinzu.
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 angegebenenNodeType .
GetAncestor(Type)	Ruft den ersten Vorgänger 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 von untergeordneten Knoten zurück, die dem angegebenen Typ entsprechen.
GetEffectiveTabStops()	Gibt ein Array aller Tabstopps zurück, die auf diesen Absatz angewendet wurden, einschließlich derer, die indirekt durch Stile oder Listen angewendet wurden.
GetEnumerator()	Bietet Unterstützung für die Iteration des For-Each-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<T>(T, Node)	Fügt den angegebenen Knoten unmittelbar nach dem angegebenen Referenzknoten ein.
InsertBefore<T>(T, 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()	Verbindet Textläufe mit gleicher Formatierung im Absatz.
NextPreOrder(Node)	Ruft den nächsten Knoten gemäß dem Pre-Order-Tree-Traversal-Algorithmus ab.
PrependChild<T>(T)	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<T>(T)	Entfernt den angegebenen untergeordneten Knoten.
RemoveSmartTags()	Entfernt alleSmartTag Nachkommenknoten des aktuellen Knotens.
SelectNodes(string)	Wählt eine Liste von Knoten aus, die dem XPath-Ausdruck entsprechen.
SelectSingleNode(string)	Wählt den erstenNode das dem XPath-Ausdruck entspricht.
ToString(SaveFormat)	Exportiert den Inhalt des Knotens in eine Zeichenfolge im angegebenen Format.
ToString(SaveOptions)	Exportiert den Inhalt des Knotens unter Verwendung der angegebenen Speicheroptionen in eine Zeichenfolge.

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 auftreten 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 minimal gültiger Absatz besteht nur aus einem Absatzumbruch. DieParagraph Die Klasse fügt automatisch das entsprechende Absatzumbruchzeichen am Ende an und dieses Zeichen ist nicht Teil der untergeordneten Knoten derParagraph , daher aParagraph kann leer sein.

Schließen Sie das Ende des Absatzes nicht einParagraphBreak oder Ende der ZelleCell Zeichen im Text von des Absatzes, da dies den Absatz ungültig machen könnte, 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 am Ende einen Dokumentknoten ohne untergeordnete Elemente erhalten.
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 zuerst 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);

// Erstellen Sie einen Absatz, legen Sie einige Formatierungseigenschaften fest und hängen Sie ihn dann als untergeordnetes Element an den Textkörper an.
Paragraph para = new Paragraph(doc);

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

body.AppendChild(para);

// Abschließend fügen Sie dem Dokument noch Inhalt hinzu. Erstellen Sie einen Lauf,
// Legen Sie das Erscheinungsbild und den Inhalt fest und hängen Sie es dann als untergeordnetes Element an den Absatz an.
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