RunCollection

RunCollection class

Bietet typisierten Zugriff auf eine Sammlung vonRun Knoten.

Um mehr zu erfahren, besuchen Sie dieProgrammieren mit Dokumenten Dokumentationsartikel.

public class RunCollection : NodeCollection

Eigenschaften

NameBeschreibung
Count { get; }Ruft die Anzahl der Knoten in der Sammlung ab.
Item { get; }Ruft a abRun am angegebenen Index. (2 indexers)

Methoden

NameBeschreibung
Add(Node)Fügt einen Knoten am Ende der Sammlung hinzu.
Clear()Entfernt alle Knoten aus dieser Sammlung und aus dem Dokument.
Contains(Node)Bestimmt, ob ein Knoten in der Sammlung ist.
GetEnumerator()Bietet eine einfache Iteration im „foreach“-Stil über die Sammlung von Knoten.
IndexOf(Node)Gibt den nullbasierten Index des angegebenen Knotens zurück.
Insert(int, Node)Fügt am angegebenen Index einen Knoten in die Sammlung ein.
Remove(Node)Entfernt den Knoten aus der Sammlung und aus dem Dokument.
RemoveAt(int)Entfernt den Knoten am angegebenen Index aus der Sammlung und aus dem Dokument.
ToArray()Kopiert alle Läufe aus der Sammlung in ein neues Array von Läufen. (2 methods)

Beispiele

Zeigt, wie der Revisionstyp eines Inline-Knotens ermittelt wird.

Document doc = new Document(MyDir + "Revision runs.docx");

// Wenn wir das Dokument bearbeiten, während die Option „Änderungen verfolgen“ über „Überprüfen ->“ verfügbar ist. Verfolgung,
// in Microsoft Word aktiviert ist, gelten die von uns vorgenommenen Änderungen als Revisionen.
// Wenn wir ein Dokument mit Aspose.Words bearbeiten, können wir mit der Nachverfolgung von Revisionen beginnen
// Aufrufen der Methode „StartTrackRevisions“ des Dokuments und Stoppen der Verfolgung mithilfe der Methode „StopTrackRevisions“.
// Wir können entweder Revisionen akzeptieren, um sie in das Dokument zu integrieren
// oder lehnen Sie sie ab, um die vorgeschlagene Änderung wirksam zu ändern.
Assert.AreEqual(6, doc.Revisions.Count);

// Der übergeordnete Knoten einer Revision ist der Lauf, den die Revision betrifft. Ein Run ist ein Inline-Knoten.
Run run = (Run)doc.Revisions[0].ParentNode;

Paragraph firstParagraph = run.ParentParagraph;
RunCollection runs = firstParagraph.Runs;

Assert.AreEqual(6, runs.ToArray().Length);

// Nachfolgend sind fünf Arten von Revisionen aufgeführt, die einen Inline-Knoten kennzeichnen können.
// 1 – Eine „einfügen“-Revision:
// Diese Überarbeitung erfolgt, wenn wir Text einfügen und gleichzeitig Änderungen verfolgen.
Assert.IsTrue(runs[2].IsInsertRevision);

// 2 – Eine „Format“-Revision:
// Diese Überarbeitung erfolgt, wenn wir die Textformatierung ändern und gleichzeitig Änderungen verfolgen.
Assert.IsTrue(runs[2].IsFormatRevision);

// 3 – Eine „Move from“-Revision:
// Wenn wir Text in Microsoft Word markieren und ihn dann an eine andere Stelle im Dokument ziehen
// Beim Verfolgen von Änderungen werden zwei Revisionen angezeigt.
// Die „Verschieben von“-Revision ist eine Kopie des ursprünglichen Textes, bevor wir ihn verschoben haben.
Assert.IsTrue(runs[4].IsMoveFromRevision);

// 4 – Eine „Move to“-Revision:
// Die „Verschieben nach“-Revision ist der Text, den wir an seine neue Position im Dokument verschoben haben.
// „Verschieben von“- und „Verschieben nach“-Revisionen erscheinen paarweise für jede von uns durchgeführte Verschiebungsrevision.
// Durch das Akzeptieren einer Verschiebungsrevision werden die „Verschiebung von“-Revision und ihr Text gelöscht.
// und behält den Text aus der „Verschieben nach“-Revision.
// Wenn Sie eine Verschiebungsrevision ablehnen, bleibt umgekehrt die „Verschieben von“-Revision erhalten und die „Verschieben nach“-Revision wird gelöscht.
Assert.IsTrue(runs[1].IsMoveToRevision);

// 5 – Eine „Lösch“-Revision:
// Diese Überarbeitung erfolgt, wenn wir Text löschen, während wir Änderungen verfolgen. Wenn wir Text wie diesen löschen,
// es bleibt als Revision im Dokument, bis wir entweder die Revision akzeptieren,
// wodurch der Text endgültig gelöscht wird oder die Überarbeitung abgelehnt wird, wodurch der von uns gelöschte Text dort verbleibt, wo er war.
Assert.IsTrue(runs[5].IsDeleteRevision);

Siehe auch