JoinRunsWithSameFormatting

Paragraph.JoinRunsWithSameFormatting method

Joins werden mit der gleichen Formatierung im Absatz ausgeführt.

public int JoinRunsWithSameFormatting()

Rückgabewert

Anzahl der durchgeführten Joins. WannN Benachbarte Läufe werden zusammengefügt, sie zählen alsN - 1 schließt sich an.

Beispiele

Zeigt, wie Absätze durch Zusammenführen überflüssiger Absätze vereinfacht werden.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Vier Textzeilen in den Absatz einfügen.
builder.Write("Run 1. ");
builder.Write("Run 2. ");
builder.Write("Run 3. ");
builder.Write("Run 4. ");

// Wenn wir dieses Dokument in Microsoft Word öffnen, sieht der Absatz wie ein nahtloser Textkörper aus.
// Es besteht jedoch aus vier separaten Läufen mit derselben Formatierung. Fragmentierte Absätze wie dieser
// kann auftreten, wenn wir Teile eines Absatzes in Microsoft Word mehrmals manuell bearbeiten.
Paragraph para = builder.CurrentParagraph;

Assert.AreEqual(4, para.Runs.Count);

// Ändere den Stil des letzten Laufs, um ihn von den ersten drei abzuheben.
para.Runs[3].Font.StyleIdentifier = StyleIdentifier.Emphasis;

// Wir können die Methode „JoinRunsWithSameFormatting“ ausführen, um den Inhalt des Dokuments zu optimieren
// indem ähnliche Läufe zu einem zusammengefasst werden, wodurch ihre Gesamtzahl reduziert wird.
// Diese Methode gibt auch die Anzahl der Läufe zurück, die diese Methode zusammengeführt hat.
// Diese beiden Zusammenführungen erfolgten, um die Läufe Nr. 1, Nr. 2 und Nr. 3 zu kombinieren.
// während Lauf Nr. 4 weggelassen wird, da er einen inkompatiblen Stil hat.
Assert.AreEqual(2, para.JoinRunsWithSameFormatting());

// Die Anzahl der verbleibenden Läufe entspricht der ursprünglichen Anzahl
// minus der Anzahl der Laufzusammenführungen, die die Methode „JoinRunsWithSameFormatting“ durchgeführt hat.
Assert.AreEqual(2, para.Runs.Count);
Assert.AreEqual("Run 1. Run 2. Run 3. ", para.Runs[0].Text);
Assert.AreEqual("Run 4. ", para.Runs[1].Text);

Siehe auch

Paragraph.InsertField