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 GoToAction ile FitType kullanı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 GoToRemoteAction kullanın.
  • Bir sayfadaki eylem koleksiyonları, sayfa açıldığında çalışan birden fazla eylem eklemenizi sağlar.

Yaygın Sorunlar

SorunNedenÇözüm
Yer imi gezinmiyorEylem, taslak öğesine ayarlanmamışGoToAction‘yi OutlineItemCollection.Action‘ye atayın
GoTo eylemi yanlış sayfayı hedefliyorSayfa indeksi dahili olarak 0 tabanlı, ancak sayfalar 1 tabanlıdırdoc.Pages[n]‘yi GoToAction yapıcısında doğrudan kullanın
Adlandırılmış eylem etkisizGörüntüleyici adlandırılmış eylemi desteklemiyorYalnı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 bir
GoToAction 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 / MetotAçıklama
OutlineCollectionBelge üzerindeki üst düzey yer imi koleksiyonu
OutlineItemCollectionBaşlık ve eylem içeren tek yer imi girişi
GoToActionAynı belge içinde bir sayfaya git
GoToRemoteActionHarici bir PDF’teki sayfaya git
LaunchActionHarici bir dosya aç
NamedActionÖnceden tanımlı görüntüleyici komutunu tetikle
PdfAction.CreateGoToGoTo eylemleri için fabrika
PdfAction.CreateNamedAdlandırılmış eylemler için fabrika
ActionCollectionBir sayfa veya açıklama üzerindeki eylemlerin koleksiyonu
DestinationCollectionAdlandırılmış hedef kaydı
ActionTypeSıralama: GoTo, URI, JavaScript, Named, Launch

Ayrıca Bakınız

 Türkçe