JoinRunsWithSameFormatting

Paragraph.JoinRunsWithSameFormatting method

I join vengono eseguiti con la stessa formattazione nel paragrafo.

public int JoinRunsWithSameFormatting()

Valore di ritorno

Numero di unioni eseguite. QuandoN le piste adiacenti vengono unite come contanoN-1 si unisce.

Esempi

Mostra come semplificare i paragrafi unendo le sequenze superflue.

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

// Inserisci quattro sequenze di testo nel paragrafo.
builder.Write("Run 1. ");
builder.Write("Run 2. ");
builder.Write("Run 3. ");
builder.Write("Run 4. ");

// Se apriamo questo documento in Microsoft Word, il paragrafo apparirà come un unico corpo di testo senza soluzione di continuità.
// Tuttavia, sarà composto da quattro esecuzioni separate con la stessa formattazione. Paragrafi frammentati come questo
// può verificarsi quando si modificano manualmente più volte parti di un paragrafo in Microsoft Word.
Paragraph para = builder.CurrentParagraph;

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

// Cambia lo stile dell'ultima esecuzione per distinguerla dalle prime tre.
para.Runs[3].Font.StyleIdentifier = StyleIdentifier.Emphasis;

// Possiamo eseguire il metodo "JoinRunsWithSameFormatting" per ottimizzare il contenuto del documento
// unendo esecuzioni simili in una sola, riducendone il conteggio complessivo.
// Questo metodo restituisce anche il numero di esecuzioni unite da questo metodo.
// Queste due fusioni sono avvenute per combinare le esecuzioni #1, #2 e #3,
// tralasciando Run #4 perché ha uno stile incompatibile.
Assert.AreEqual(2, para.JoinRunsWithSameFormatting());

// Il numero di esecuzioni rimaste sarà uguale al conteggio originale
// meno il numero di unioni di esecuzioni eseguite dal metodo "JoinRunsWithSameFormatting".
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);

Guarda anche

Paragraph.InsertField