Gezinti ve İşlemler
Navigasyon ve İşlemler
Aspose.PDF FOSS for .NET, PDF gezinme yapılarını — yer imleri (taslaklar), sayfa hedefleri ve belge eylemlerini destekler. Bunlar, içindekiler tablosu gezinmesi, sayfalar arası bağlantılar ve JavaScript tetikleyicileriyle etkileşimli belgeler oluşturmanıza olanak tanır.
Belge anahatları (yer imleri)
OutlineCollection belgeye ait yer imi ağacını tutar. Her OutlineItemCollection bir başlık ve hedefe sahip bir yer imi girişidir.
using var doc = Document.Open(pdfBytes);
foreach (var item in doc.Outlines)
{
Console.WriteLine($"Bookmark: {item.Title}");
}Yer imleri oluşturma
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");GoTo eylemleri
GoToAction aynı belge içinde belirli bir sayfaya ve sığdırma tipine gider.
var goTo = new GoToAction(doc.Pages[3]);Adlandırılmış eylemler
NamedAction önceden tanımlı PDF görüntüleyici komutlarını, örneğin NextPage,
PrevPage, FirstPage ve LastPage, tetikler.
var nextPage = PdfAction.CreateNamed("NextPage");GoToRemote eylemleri
GoToRemoteAction harici bir PDF dosyası açar ve belirli bir sayfaya gider.
var remote = new GoToRemoteAction("other.pdf", 1);Eylemleri Başlat
LaunchAction bir PDF bağlantısından harici bir dosya (herhangi bir format) açar.
var launch = new LaunchAction("readme.txt");Hedef koleksiyonları
DestinationCollection adlandırılmış hedefleri sayfalara eşler, büyük belgelerde çapraz referans gezinmesini destekler.
var dest = doc.Destinations;
int pageNum = dest.GetPageNumber("section2");İpuçları ve En İyi Uygulamalar
- Belgenizin bölüm hiyerarşisini yansıtan bir yer imi ağacı oluşturun, sezgisel gezinme için.
- Hedef sayfanın nasıl görüntüleneceğini (genişliğe sığdır, sayfaya sığdır, vb.) kontrol etmek için
GoToActionileFitTypekullanın. - Adlandırılmış eylemler görüntüleyiciye bağlıdır — standart adlara (NextPage, PrevPage, FirstPage, LastPage) sadık kalın.
- Belgeler arası bağlantılar için PDF dosyalarına işaret eden URI eylemleri yerine
GoToRemoteActionkullanın. - Bir sayfadaki eylem koleksiyonları, sayfa açıldığında çalışan birden fazla eylem eklemenizi sağlar.
Yaygın Sorunlar
| Sorun | Neden | Çözüm |
|---|---|---|
| Yer imi gezinmiyor | Eylem, taslak öğesine ayarlanmamış | GoToAction‘yi OutlineItemCollection.Action‘ye atayın |
| GoTo eylemi yanlış sayfayı hedefliyor | Sayfa indeksi dahili olarak 0 tabanlı, ancak sayfalar 1 tabanlıdır | doc.Pages[n]‘yi GoToAction yapıcısında doğrudan kullanın |
| Adlandırılmış eylem etkisiz | Görüntüleyici adlandırılmış eylemi desteklemiyor | Yalnızca standart adları kullanın |
SSS
İçindekiler tablosu nasıl oluşturulur?
Her bölüm için OutlineItemCollection girişleri oluşturun, her biri birGoToAction ile bölümün ilk sayfasını hedefler.
Yer imlerini iç içe yerleştirebilir miyim?
Evet. Hiyerarşik bir taslak oluşturmak için bir üst yer imine alt OutlineItemCollection girişleri ekleyin.
GoTo eylemleri için hangi uyum türleri mevcuttur?
Fit, FitH (genişliği sığdır), FitV (yüksekliği sığdır), FitR (dikdörtgeni sığdır), ve FitB
(sınırlayıcı kutuyu sığdır).
API Referans Özeti
| Sınıf / Metot | Açıklama |
|---|---|
OutlineCollection | Belge üzerindeki üst düzey yer imi koleksiyonu |
OutlineItemCollection | Başlık ve eylem içeren tek yer imi girişi |
GoToAction | Aynı belge içinde bir sayfaya git |
GoToRemoteAction | Harici bir PDF’teki sayfaya git |
LaunchAction | Harici bir dosya aç |
NamedAction | Önceden tanımlı görüntüleyici komutunu tetikle |
PdfAction.CreateGoTo | GoTo eylemleri için fabrika |
PdfAction.CreateNamed | Adlandırılmış eylemler için fabrika |
ActionCollection | Bir sayfa veya açıklama üzerindeki eylemlerin koleksiyonu |
DestinationCollection | Adlandırılmış hedef kaydı |
ActionType | Sıralama: GoTo, URI, JavaScript, Named, Launch |