InsertTableOfContents

DocumentBuilder.InsertTableOfContents method

Inserisce un campo TOC (tabella dei contenuti) nel documento.

public Field InsertTableOfContents(string switches)
ParametroTipoDescrizione
switchesStringIl campo TOC cambia.

Osservazioni

Questo metodo inserisce un campo TOC (tabella dei contenuti) nel documento nella posizione corrente.

Un sommario in un documento di Word può essere creato in diversi modi e formattato utilizzando una varietà di opzioni. Il modo in cui la tabella viene creata e visualizzata da Microsoft Word è controllata dalle opzioni di campo.

Il modo più semplice per specificare le opzioni è inserire e configurare una tabella di contenuto in un documento Word utilizzando il menu Inserisci->Riferimento->Indice e tabelle, quindi attivare la visualizzazione dei codici di campo per vedere le opzioni. È possibile premere Alt+F9 in Microsoft Word per attivare o disattivare la visualizzazione dei codici di campo.

Ad esempio, dopo aver creato un sommario, nel documento viene inserito il seguente campo :{ SOMMARIO \o “1-3” \h \z \u } . Puoi copiare**\o “1-3” \h \z \u** e usarlo come parametro switch.

Notare cheInsertTableOfContents inserirà solo un campo TOC, ma non creerà effettivamente il sommario. Il sommario viene creato da Microsoft Word quando il campo viene aggiornato.

Se inserisci un sommario utilizzando questo metodo e quindi apri il file in Microsoft Word, non vedrai il sommario perché il campo TOC non è stato ancora aggiornato.

In Microsoft Word, i campi non vengono aggiornati automaticamente all’apertura di un documento, ma puoi aggiornare i campi in un documento in qualsiasi momento premendo F9.

Esempi

Mostra come inserire un sommario (TOC) in un documento utilizzando gli stili di titolo come voci.

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

// Inserisci un sommario per la prima pagina del documento.
// Configura la tabella per raccogliere paragrafi con titoli di livello da 1 a 3.
// Inoltre, imposta le sue voci come collegamenti ipertestuali che ci porteranno
// alla posizione dell'intestazione quando si fa clic con il pulsante sinistro del mouse in Microsoft Word.
builder.InsertTableOfContents("\\o \"1-3\" \\h \\z \\u");
builder.InsertBreak(BreakType.PageBreak);

// Compila il sommario aggiungendo paragrafi con stili di intestazione.
// Ciascuna di queste intestazioni con un livello compreso tra 1 e 3 creerà una voce nella tabella.
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading1;
builder.Writeln("Heading 1");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;
builder.Writeln("Heading 1.1");
builder.Writeln("Heading 1.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading1;
builder.Writeln("Heading 2");
builder.Writeln("Heading 3");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;
builder.Writeln("Heading 3.1");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading3;
builder.Writeln("Heading 3.1.1");
builder.Writeln("Heading 3.1.2");
builder.Writeln("Heading 3.1.3");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading4;
builder.Writeln("Heading 3.1.3.1");
builder.Writeln("Heading 3.1.3.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;
builder.Writeln("Heading 3.2");
builder.Writeln("Heading 3.3");

// Un sommario è un campo di tipo che deve essere aggiornato per mostrare un risultato aggiornato.
doc.UpdateFields();
doc.Save(ArtifactsDir + "DocumentBuilder.InsertToc.docx");

Guarda anche

DocumentBuilder.InsertStyleSeparator DocumentBuilder.InsertTextInput