Generazione del sommario in Aspose.Words per Java

Introduzione alla generazione del sommario in Aspose.Words per Java

In questo tutorial, ti guideremo attraverso il processo di generazione di un sommario (TOC) utilizzando Aspose.Words per Java. Il sommario è una funzionalità cruciale per la creazione di documenti organizzati. Tratteremo come personalizzare l’aspetto e il layout del sommario.

Prerequisiti

Prima di iniziare, assicurati di avere Aspose.Words per Java installato e configurato nel tuo progetto Java.

Passaggio 1: crea un nuovo documento

Innanzitutto, creiamo un nuovo documento con cui lavorare.

Document doc = new Document();

Passaggio 2: personalizza gli stili del sommario

Per personalizzare l’aspetto del tuo sommario, puoi modificare gli stili ad esso associati. In questo esempio, le voci del sommario di primo livello verranno rese in grassetto.

doc.getStyles().getByStyleIdentifier(StyleIdentifier.TOC_1).getFont().setBold(true);

Passaggio 3: aggiungi contenuto al tuo documento

Puoi aggiungere il tuo contenuto al documento. Questo contenuto verrà utilizzato per generare il sommario.

Passaggio 4: generare il sommario

Per generare il sommario, inserisci un campo TOC nella posizione desiderata nel documento. Questo campo verrà compilato automaticamente in base alle intestazioni e agli stili del documento.

// Inserisci un campo TOC nella posizione desiderata nel documento.
FieldToc fieldToc = new FieldToc();
doc.getFirstSection().getBody().getFirstParagraph().appendChild(fieldToc);

Passaggio 5: salva il documento

Infine, salva il documento con il sommario.

doc.save("your_output_path_here");

Personalizzazione delle tabulazioni nel sommario

Puoi anche personalizzare le tabulazioni nel sommario per controllare il layout dei numeri di pagina. Ecco come puoi modificare le tabulazioni:

Document doc = new Document("Table of contents.docx");

for (Paragraph para : (Iterable<Paragraph>) doc.getChildNodes(NodeType.PARAGRAPH, true))
{
    if (para.getParagraphFormat().getStyle().getStyleIdentifier() >= StyleIdentifier.TOC_1 &&
        para.getParagraphFormat().getStyle().getStyleIdentifier() <= StyleIdentifier.TOC_9)
    {
        //Ottieni la prima scheda utilizzata in questo paragrafo, che allinea i numeri di pagina.
        TabStop tab = para.getParagraphFormat().getTabStops().get(0);
        
        // Rimuovi la vecchia scheda.
        para.getParagraphFormat().getTabStops().removeByPosition(tab.getPosition());
        
        // Inserire una nuova scheda in una posizione modificata (ad esempio, 50 unità a sinistra).
        para.getParagraphFormat().getTabStops().add(tab.getPosition() - 50.0, tab.getAlignment(), tab.getLeader());
    }
}

doc.save("output.docx");

Ora hai un sommario personalizzato nel tuo documento con tabulazioni regolate per l’allineamento del numero di pagina.

Conclusione

In questo tutorial, abbiamo esplorato come generare un sommario (TOC) utilizzando Aspose.Words per Java, una potente libreria per lavorare con documenti Word. Un sommario ben strutturato è essenziale per organizzare e navigare in documenti lunghi e Aspose.Words fornisce gli strumenti per creare e personalizzare i sommari senza sforzo.

Domande frequenti

Come posso modificare la formattazione delle voci del sommario?

È possibile modificare gli stili associati ai livelli di sommario utilizzandodoc.getStyles().getByStyleIdentifier(StyleIdentifier.TOC_X), dove X è il livello TOC.

Come posso aggiungere più livelli al mio sommario?

Per includere più livelli nel sommario, puoi modificare il campo TOC e specificare il numero di livelli desiderato.

Posso modificare le posizioni dei punti di tabulazione per voci di sommario specifiche?

Sì, come mostrato nell’esempio di codice sopra, puoi modificare le posizioni dei punti di tabulazione per voci di sommario specifiche scorrendo i paragrafi e modificando i punti di tabulazione di conseguenza.