Java'da PDF Yer İşaretleri ve Anahat Nasıl Eklenir

Başlamadan Önce Neye İhtiyacım Var?

PDF yer imlerini uygulamadan önce, IronPDF'nin Java projenizde ayarlandığından emin olun. Kütüphane, Java 8 veya daha yüksek sürümleri gerektirir ve Maven veya Gradle aracılığıyla entegre olur. Projenizin derleme dosyasına IronPDF bağımlılığını ekleyin. Daha ayrıntılı kurulum talimatları için Başlangıç Özetine bakın.

Geliştirme ve üretim kullanımı için geçerli bir lisans anahtarı gereklidir. Uygulamanızın başında lisans anahtarını ayarlayın ve herhangi bir IronPDF yöntemini çağırmadan önce bunu yapın. Lisanslama" target="_blank">https://ironpdf.com/java/get-started/license-keys/">Lisanslama seçenekleriyle ilgili bilgi için lisans kılavuzunu ziyaret edin

Bir PDF'ye Özet ve Yer İmleri Nasıl Eklerim?

Aşağıdaki örnekler, özet ve yer imi oluşturmayı göstermek için bu örnek PDF'yi kullanır. Bu işlem, mevcut bir PDF belgesinin yüklenmesini ve belgenin tamamına gezinme noktalarının eklenmesini sağlayan IronPDF BookmarkManager kullanılarak gerçekleştirilir.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/single-layer.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file
        PdfDocument pdf = PdfDocument.fromFile(Path.of("NovelSample.pdf"));

        // Get BookmarkManager object to manage bookmarks
        BookmarkManager bookmarks = pdf.getBookmark();

        // Add bookmarks at the end of the bookmark collection
        bookmarks.addBookMarkAtEnd("Title Page", 0);
        bookmarks.addBookMarkAtEnd("Table of Contents", 1);
        bookmarks.addBookMarkAtEnd("Dedication Page", 2);
        bookmarks.addBookMarkAtEnd("First Page", 3);
        bookmarks.addBookMarkAtStart("Page 4", 6);

        // Save the modified PDF with bookmarks
        pdf.saveAs(Path.of("bookmarked.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/single-layer.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file
        PdfDocument pdf = PdfDocument.fromFile(Path.of("NovelSample.pdf"));

        // Get BookmarkManager object to manage bookmarks
        BookmarkManager bookmarks = pdf.getBookmark();

        // Add bookmarks at the end of the bookmark collection
        bookmarks.addBookMarkAtEnd("Title Page", 0);
        bookmarks.addBookMarkAtEnd("Table of Contents", 1);
        bookmarks.addBookMarkAtEnd("Dedication Page", 2);
        bookmarks.addBookMarkAtEnd("First Page", 3);
        bookmarks.addBookMarkAtStart("Page 4", 6);

        // Save the modified PDF with bookmarks
        pdf.saveAs(Path.of("bookmarked.pdf"));
    }
}

Nasıl Birden Fazla Katmanda Yer İşareti Oluşturabilirim?

Yerleşik yer imleri, teknik dokümantasyon, araştırma raporları veya okuyucuların sadece bölümlere değil, bölümler içindeki alt bölümlere de gitmesi gereken çoklu bölüm belgeleri için doğru tercihtir. Önceki bölümde oluşturulan aynı düz yer imleriyle başlayın, ardından yeni katmanlarda girişler eklemek için insertBookmark yöntemini kullanın.

insertBookmark yöntemi dört parametre kabul eder: yer imi adı, hedef sayfa dizini, öğe yer iminin adı ve önceki kardeş yer ima adı. Bir üst yer imi adı geçirerek, altına yerleşik bir alt giriş oluşturursunuz. Kardeş parametresini null olarak ayarlamak, yeni girişi o ebeveynin ilk çocuğu olarak yerleştirir.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/multi-layer.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file
        PdfDocument pdf = PdfDocument.fromFile(Path.of("NovelSample.pdf"));

        // Get BookmarkManager object
        BookmarkManager bookmarks = pdf.getBookmark();

        // Add top-level bookmarks at the end
        bookmarks.addBookMarkAtEnd("Title Page", 0);
        bookmarks.addBookMarkAtEnd("Table of Contents", 1);
        bookmarks.addBookMarkAtEnd("Dedication", 2);

        // Insert second-layer bookmarks as children of existing entries
        bookmarks.insertBookmark("First Page", 3, "Table of Contents", null);
        bookmarks.insertBookmark("Second Page", 4, "Table of Contents", "First Page");
        bookmarks.insertBookmark("End of Sample", 7, "Title Page", null);
        bookmarks.insertBookmark("Fourth page", 6, "Table of Contents", "Second Page");

        // Save the modified PDF with nested bookmarks
        pdf.saveAs(Path.of("multiLayer.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/multi-layer.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file
        PdfDocument pdf = PdfDocument.fromFile(Path.of("NovelSample.pdf"));

        // Get BookmarkManager object
        BookmarkManager bookmarks = pdf.getBookmark();

        // Add top-level bookmarks at the end
        bookmarks.addBookMarkAtEnd("Title Page", 0);
        bookmarks.addBookMarkAtEnd("Table of Contents", 1);
        bookmarks.addBookMarkAtEnd("Dedication", 2);

        // Insert second-layer bookmarks as children of existing entries
        bookmarks.insertBookmark("First Page", 3, "Table of Contents", null);
        bookmarks.insertBookmark("Second Page", 4, "Table of Contents", "First Page");
        bookmarks.insertBookmark("End of Sample", 7, "Title Page", null);
        bookmarks.insertBookmark("Fourth page", 6, "Table of Contents", "Second Page");

        // Save the modified PDF with nested bookmarks
        pdf.saveAs(Path.of("multiLayer.pdf"));
    }
}

JAVA

Yukarıdaki PDF, insertBookmark tarafından oluşturulan yer imlerinin ağaç yapısını gösterir. Her bir çocuk girişin üstünün altına nasıl yerleştirildiğini doğrulamak için ana hat panelini genişletin. Bu katmanlı yaklaşım, bölümler, alt bölümler ve eklerle raporlar için uygundur.

---

Bu türden favori kütüphanem IronPDF'dir. PDF dosyalarının hızlı ve verimli bir şekilde işlenmesine olanak tanır. Ayrıca, PDF/A formatına dışa aktarma ve dijital imzalama gibi birçok değerli özelliğe sahiptir.

Milan Jovanovic

Microsoft MVP

Vaka çalışmasını görüntüle

IronOCR, manuel işleme maliyetinden yıllık 40.000 USD tasarruf etmemizi sağlıyor, üretkenliği artırıyor ve yüksek etkili görevler için kaynakları serbest bırakıyor. Kesinlikle tavsiye ederim.

Brent Matzelle

Teknoloji Müdürü, OPYN

Vaka çalışmasını görüntüle

IronSuite, operasyonlarımızda kritik bir rol oynar. Bunlar, iş süreçlerinde verimliliği artıran, kat planları oluşturmak ve envanter yönetimini geliştirmek gibi araçlardır.

David Jones

Baş Yazılım Mühendisi, Agorus Build

Vaka çalışmasını görüntüle

Mevcut Yer İmlerini Bir PDF'den Nasıl Alırım?

Bir PDF'den yer imi verilerini okumak, tüm gezinme yapısını yeniden inşa etmeden belgeleri güncellerken gereklidir. IronPDF bunu, yer imleri eklemek için kullanılan aynı BookmarkManager arayüzü aracılığıyla erişilebilir hale getirir. PDF'i PdfDocument.fromFile() ile yükleyin, BookmarkManager erişin, ardından tüm üst düzey yer imlerini almak için getBookmarks() çağırın.

Bir listenin içindeki konumu ile belirli bir yer ima erişmek için get(index) kullanın. getText() yöntemi yer iminin görüntü etiketini döndürürken, getPageIndex() sıfır tabanlı olarak hedeflenen sayfa numarasını döndürür. Çocuk yer imleri, getBookmarks() tarafından geri döndürülen düz listede dahil değildir; her bir öğe yer imi getChildren() yöntemiyle onlara erişin.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/retrieve-bookmarks.java
import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file with bookmarks
        PdfDocument pdf = PdfDocument.fromFile(Path.of("bookmarked.pdf"));

        // Retrieve the bookmark manager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve list of all bookmarks (includes child bookmarks)
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Access a specific bookmark by zero-based index
        Bookmark bookmark = bookmarkList.get(2);

        // Print bookmark details
        System.out.println("Bookmark Title: " + bookmark.getText());
        System.out.println("Page Number: " + bookmark.getPageIndex());

        // Check if bookmark has children
        if (bookmark.getChildren() != null && !bookmark.getChildren().isEmpty()) {
            System.out.println("Number of child bookmarks: " + bookmark.getChildren().size());
        }
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/retrieve-bookmarks.java
import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file with bookmarks
        PdfDocument pdf = PdfDocument.fromFile(Path.of("bookmarked.pdf"));

        // Retrieve the bookmark manager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve list of all bookmarks (includes child bookmarks)
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Access a specific bookmark by zero-based index
        Bookmark bookmark = bookmarkList.get(2);

        // Print bookmark details
        System.out.println("Bookmark Title: " + bookmark.getText());
        System.out.println("Page Number: " + bookmark.getPageIndex());

        // Check if bookmark has children
        if (bookmark.getChildren() != null && !bookmark.getChildren().isEmpty()) {
            System.out.println("Number of child bookmarks: " + bookmark.getChildren().size());
        }
    }
}

The getBookmarks() yöntemi yalnızca en üst düzey yer imlerinin düz bir listesini döndürür. Tam yer imi ağacını gezmek için, iç içe yerleri olan her bir yer imi üzerinde getChildren() yöntemini özyinelemeli olarak çağırın.)

Bu geri alma deseni, bir PDF'in dağıtımdan önceki gezinme yapısını denetlerken veya yayın öncesi gereksinim bölümlerinin doğru şekilde yer imlendiğini doğrulayan araçlar oluşturulurken kullanışlıdır.

Belirli Bir İndekste Yer İmi Nasıl Eklenir?

Belirli bir konumda yer imleri eklemek, mevcut PDF'leri yeniden inşa etmeden, yeni bölümler ekleyerek kademeli olarak güncellemenizi sağlar. Bu, özellikle PDF'ler bir hat içinde oluşturulup değiştirildiğinde ve yeni içerik aşağı akışta eklendiğinde faydalıdır.

Düz yer imleri listesini getBookmarks() kullanarak alın, hedef yer imini listedeki dizini ile seçin ve hemen ardından yeni bir kardeş eklemek için addNextBookmark çağırın. Seçilen yer iminin altına bir seviye derine yeni bir giriş yerleştirmek için addChildBookmark kullanın. Her iki yöntem de bir başlık dizisini ve sıfır tabanlı bir sayfa indeksini kabul eder.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/insert-at-index.java
import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF modified in the multi-layer example
        PdfDocument pdf = PdfDocument.fromFile(Path.of("multiLayer.pdf"));

        // Get the BookmarkManager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve the flat bookmark list
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Select a bookmark at a specific index
        Bookmark bookmark = bookmarkList.get(5);

        // Insert a new bookmark after the selected entry
        bookmark.addNextBookmark("Fourth Page", 6);

        // Add a child bookmark under the selected entry
        bookmark.addChildBookmark("Section 1", 7);

        // Save the updated PDF
        pdf.saveAs(Path.of("specificIndex.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/insert-at-index.java
import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF modified in the multi-layer example
        PdfDocument pdf = PdfDocument.fromFile(Path.of("multiLayer.pdf"));

        // Get the BookmarkManager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve the flat bookmark list
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Select a bookmark at a specific index
        Bookmark bookmark = bookmarkList.get(5);

        // Insert a new bookmark after the selected entry
        bookmark.addNextBookmark("Fourth Page", 6);

        // Add a child bookmark under the selected entry
        bookmark.addChildBookmark("Section 1", 7);

        // Save the updated PDF
        pdf.saveAs(Path.of("specificIndex.pdf"));
    }
}

addNextBookmark yöntemi yeni girişi, hemen ardından listede, seçilen yer iminin bir kardeşi olarak ekler. addChildBookmark yöntemi yeni girişi, seçilen yer iminin altında, bir seviye derine yerleştirir. Her iki yöntem de bir başlık dizisini ve sıfır tabanlı bir sayfa indeksini kabul eder.

Java'da PDF Yer İmleri İçin Bir Sonraki Adım Nedir?

PDF yer imleri, kullanıcıların karışık belgelerde kaydırmadan doğrudan gezintiye çıkmalarını sağlar. IronPDF'nin BookmarkManager, düz giriş listeleri ekleme, derin çok seviyeli anahatlar oluşturma, mevcut girişleri alma ve belirli pozisyonlarda ekleme dahil, tüm yer imi işlemleri yelpazesini yönetir.

Belge yapısı ve gezinme özellikleriyle çalışmaya devam etmek için bu ilgili kaynakları keşfedin:

• Java'da PDF'leri Böl: her biri kendi yer imi yapısını taşıyan daha küçük, bağımsız belgeler oluşturun
• Java'da PDF'leri Yazdır: yer imlenmiş belgeleri gezinme korunarak bir yazıcıya gönderin
• Java PDF eğitimleri: yaygın PDF iş akışları için ek uçtan uca örnekler
• Java'da PDF'lere Ek Açıklamalar Ekle: belirli sayfa konumlarına yorum ve işaret ekleyin
• IronPDF for Java örnekleri: tüm IronPDF Java API'si için kopyala-yapıştır kod örnekleri

Ücretsiz denemenizi başlatın ve yer imleri, anahatlar ve diğer gezinme özelliklerini Java PDF iş akışınıza ekleyin. Üretim kullanımı için bir lisans satın almak isterseniz, lisanslama seçeneklerini görüntüleyin.