Generowanie spisu treści w Aspose.Words dla Java

Wprowadzenie do generowania spisu treści w Aspose.Words dla Java

W tym samouczku przeprowadzimy Cię przez proces generowania spisu treści (TOC) przy użyciu Aspose.Words dla Java. Spis treści jest kluczową funkcją tworzenia uporządkowanych dokumentów. Omówimy, jak dostosować wygląd i układ spisu treści.

Warunki wstępne

Zanim zaczniesz, upewnij się, że masz zainstalowany i skonfigurowany Aspose.Words for Java w swoim projekcie Java.

Krok 1: Utwórz nowy dokument

Najpierw utwórzmy nowy dokument do pracy.

Document doc = new Document();

Krok 2: Dostosuj style spisu treści

Aby dostosować wygląd spisu treści, możesz modyfikować powiązane z nim style. W tym przykładzie pogrubimy wpisy spisu treści pierwszego poziomu.

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

Krok 3: Dodaj treść do swojego dokumentu

Możesz dodać swoją treść do dokumentu. Ta treść zostanie wykorzystana do wygenerowania spisu treści.

Krok 4: Wygeneruj spis treści

Aby wygenerować spis treści, wstaw pole spisu treści w żądanym miejscu w dokumencie. To pole zostanie automatycznie wypełnione na podstawie nagłówków i stylów w dokumencie.

// Wstaw pole spisu treści w żądanym miejscu w dokumencie.
FieldToc fieldToc = new FieldToc();
doc.getFirstSection().getBody().getFirstParagraph().appendChild(fieldToc);

Krok 5: Zapisz dokument

Na koniec zapisz dokument ze spisem treści.

doc.save("your_output_path_here");

Dostosowywanie tabulatorów w spisie treści

Możesz także dostosować tabulatory w spisie treści, aby kontrolować układ numerów stron. Oto jak zmienić tabulatory:

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)
    {
        //Uzyskaj pierwszą zakładkę używaną w tym akapicie, która wyrównuje numery stron.
        TabStop tab = para.getParagraphFormat().getTabStops().get(0);
        
        // Usuń starą zakładkę.
        para.getParagraphFormat().getTabStops().removeByPosition(tab.getPosition());
        
        // Wstaw nową zakładkę w zmodyfikowanej pozycji (np. 50 jednostek w lewo).
        para.getParagraphFormat().getTabStops().add(tab.getPosition() - 50.0, tab.getAlignment(), tab.getLeader());
    }
}

doc.save("output.docx");

Teraz masz dostosowany spis treści w swoim dokumencie z dostosowanymi tabulatorami w celu wyrównania numerów stron.

Wniosek

W tym samouczku omówiliśmy, jak wygenerować spis treści (TOC) przy użyciu Aspose.Words dla języka Java, potężnej biblioteki do pracy z dokumentami programu Word. Dobrze zorganizowany spis treści jest niezbędny do organizowania długich dokumentów i poruszania się po nich, a Aspose.Words zapewnia narzędzia do łatwego tworzenia i dostosowywania spisów treści.

Często zadawane pytania

Jak zmienić formatowanie wpisów spisu treści?

Możesz modyfikować style powiązane z poziomami spisu treści za pomocądoc.getStyles().getByStyleIdentifier(StyleIdentifier.TOC_X), gdzie X to poziom spisu treści.

Jak mogę dodać więcej poziomów do mojego spisu treści?

Aby uwzględnić więcej poziomów w spisie treści, możesz zmodyfikować pole spisu treści i określić żądaną liczbę poziomów.

Czy mogę zmienić pozycje tabulatorów dla określonych wpisów spisu treści?

Tak, jak pokazano w powyższym przykładzie kodu, możesz zmieniać pozycje tabulatorów dla określonych wpisów spisu treści, iterując po akapitach i odpowiednio modyfikując tabulatory.