Navigasi dan Tindakan

Navigasi dan Tindakan

Aspose.PDF FOSS for .NET mendukung struktur navigasi PDF — bookmark (outline), tujuan halaman, dan aksi dokumen. Ini memungkinkan Anda membuat dokumen interaktif dengan navigasi daftar isi, tautan lintas halaman, dan pemicu JavaScript.

Garis besar dokumen (penanda)

OutlineCollection menyimpan pohon bookmark dokumen. Setiap OutlineItemCollection adalah entri bookmark dengan judul dan tujuan.

using var doc = Document.Open(pdfBytes);

foreach (var item in doc.Outlines)
{
    Console.WriteLine($"Bookmark: {item.Title}");
}

Membuat bookmark

using var doc = Document.Open(pdfBytes);

var bookmark = new OutlineItemCollection(doc.Outlines);
bookmark.Title = "Chapter 1";
bookmark.Action = new GoToAction(doc.Pages[1]);
doc.Outlines.Add(bookmark);

doc.Save("with-bookmarks.pdf");

Aksi GoTo

GoToAction menavigasi ke halaman tertentu dan tipe penyesuaian dalam dokumen yang sama.

var goTo = new GoToAction(doc.Pages[3]);

Aksi bernama

NamedAction memicu perintah penampil PDF yang telah ditentukan sebelumnya seperti NextPage, PrevPage, FirstPage, dan LastPage.

var nextPage = PdfAction.CreateNamed("NextPage");

Aksi GoToRemote

GoToRemoteAction membuka file PDF eksternal dan menavigasi ke halaman tertentu.

var remote = new GoToRemoteAction("other.pdf", 1);

Luncurkan tindakan

LaunchAction membuka file eksternal (format apa pun) dari tautan PDF.

var launch = new LaunchAction("readme.txt");

Koleksi tujuan

DestinationCollection memetakan tujuan bernama ke halaman, mendukung navigasi referensi silang dalam dokumen besar.

var dest = doc.Destinations;
int pageNum = dest.GetPageNumber("section2");

Tips dan Praktik Terbaik

• Bangun pohon bookmark yang mencerminkan hierarki bagian dokumen Anda untuk navigasi yang intuitif.
• Gunakan GoToAction dengan FitType untuk mengontrol bagaimana halaman target ditampilkan (fit width, fit page, dll.).
• Aksi bernama bergantung pada penampil — gunakan nama standar (NextPage, PrevPage, FirstPage, LastPage).
• Untuk tautan lintas dokumen, gunakan GoToRemoteAction alih-alih aksi URI yang mengarah ke file PDF.
• Koleksi aksi pada halaman memungkinkan Anda menambahkan beberapa aksi yang dijalankan saat halaman dibuka.

Masalah Umum

FAQ

Bagaimana cara membuat daftar isi?

Buat entri OutlineItemCollection untuk setiap bagian, masing-masing dengan GoToAction yang menargetkan halaman pertama bagian tersebut.

Bisakah saya menyusun bookmark secara bersarang?

Ya. Tambahkan entri anak OutlineItemCollection ke bookmark induk untuk membuat kerangka hierarkis.

Jenis fit apa yang tersedia untuk tindakan GoTo?

Fit, FitH (lebar sesuai), FitV (tinggi sesuai), FitR (persegi panjang sesuai), dan FitB (kotak pembatas sesuai).

Ringkasan Referensi API

Lihat Juga

• Aspose.PDF untuk .NET Enterprise Product