Gerando Índice em Aspose.Words para Java

Introdução à geração de índices no Aspose.Words para Java

Neste tutorial, vamos orientá-lo no processo de geração de um Índice (TOC) usando o Aspose.Words para Java. O TOC é um recurso crucial para criar documentos organizados. Abordaremos como personalizar a aparência e o layout do TOC.

Pré-requisitos

Antes de começar, certifique-se de ter o Aspose.Words para Java instalado e configurado no seu projeto Java.

Etapa 1: Crie um novo documento

Primeiro, vamos criar um novo documento para trabalhar.

Document doc = new Document();

Etapa 2: personalizar estilos de TOC

Para personalizar a aparência do seu TOC, você pode modificar os estilos associados a ele. Neste exemplo, deixaremos as entradas do TOC de primeiro nível em negrito.

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

Etapa 3: adicione conteúdo ao seu documento

Você pode adicionar seu conteúdo ao documento. Este conteúdo será usado para gerar o TOC.

Etapa 4: Gerar o TOC

Para gerar o TOC, insira um campo TOC no local desejado no seu documento. Este campo será preenchido automaticamente com base nos títulos e estilos do seu documento.

// Insira um campo TOC no local desejado no seu documento.
FieldToc fieldToc = new FieldToc();
doc.getFirstSection().getBody().getFirstParagraph().appendChild(fieldToc);

Etapa 5: Salve o documento

Por fim, salve o documento com o TOC.

doc.save("your_output_path_here");

Personalizando paradas de tabulação no TOC

Você também pode personalizar as paradas de tabulação no seu TOC para controlar o layout dos números de página. Veja como você pode alterar as paradas de tabulação:

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)
    {
        // Obtenha a primeira tabulação usada neste parágrafo, que alinha os números das páginas.
        TabStop tab = para.getParagraphFormat().getTabStops().get(0);
        
        // Remova a aba antiga.
        para.getParagraphFormat().getTabStops().removeByPosition(tab.getPosition());
        
        //Insira uma nova aba em uma posição modificada (por exemplo, 50 unidades à esquerda).
        para.getParagraphFormat().getTabStops().add(tab.getPosition() - 50.0, tab.getAlignment(), tab.getLeader());
    }
}

doc.save("output.docx");

Agora você tem um Índice personalizado no seu documento com paradas de tabulação ajustadas para alinhamento de número de página.

Conclusão

Neste tutorial, exploramos como gerar um Índice (TOC) usando o Aspose.Words para Java, uma biblioteca poderosa para trabalhar com documentos do Word. Um TOC bem estruturado é essencial para organizar e navegar em documentos longos, e o Aspose.Words fornece as ferramentas para criar e personalizar TOCs sem esforço.

Perguntas frequentes

Como altero a formatação das entradas do TOC?

Você pode modificar os estilos associados aos níveis do TOC usandodoc.getStyles().getByStyleIdentifier(StyleIdentifier.TOC_X), onde X é o nível de TOC.

Como posso adicionar mais níveis ao meu TOC?

Para incluir mais níveis no seu índice, você pode modificar o campo índice e especificar o número desejado de níveis.

Posso alterar as posições de parada de tabulação para entradas específicas do sumário?

Sim, conforme mostrado no exemplo de código acima, você pode alterar as posições das paradas de tabulação para entradas específicas do índice iterando pelos parágrafos e modificando as paradas de tabulação adequadamente.