Generazione di un indice in Aspose.Words per Java

Introduzione alla generazione di un indice in Aspose.Words per Java

In questo tutorial, ti guideremo attraverso il processo di generazione di un indice (TOC) utilizzando Aspose.Words per Java. L’indice è una funzionalità fondamentale per la creazione di documenti organizzati. Spiegheremo come personalizzare l’aspetto e il layout dell’indice.

Prerequisiti

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

Passaggio 1: creare un nuovo documento

Per prima cosa, creiamo un nuovo documento con cui lavorare.

Document doc = new Document();

Passaggio 2: personalizzare gli stili del sommario

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

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 TOC.

Passaggio 4: generare il sommario

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

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

Passaggio 5: Salvare il documento

Infine, salva il documento con l’indice.

doc.save("your_output_path_here");

Personalizzazione delle tabulazioni nel sommario

Puoi anche personalizzare le tabulazioni nel tuo indice per controllare il layout dei numeri di pagina. Ecco come puoi cambiare 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 tabulazione utilizzata in questo paragrafo, che allinea i numeri di pagina.
        TabStop tab = para.getParagraphFormat().getTabStops().get(0);
        
        // Rimuovere la vecchia linguetta.
        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 indice personalizzato nel tuo documento con tabulazioni regolate per l’allineamento dei numeri di pagina.

Conclusione

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

Domande frequenti

Come posso modificare la formattazione delle voci dell’indice?

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

Come posso aggiungere altri livelli al mio TOC?

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

Posso modificare le posizioni delle tabulazioni per voci specifiche dell’indice?

Sì, come mostrato nell’esempio di codice sopra, è possibile modificare le posizioni delle tabulazioni per voci specifiche dell’indice scorrendo i paragrafi e modificando di conseguenza le tabulazioni.