التنقل والإجراءات

التنقل والإجراءات

Aspose.PDF FOSS for .NET يدعم هياكل تنقل PDF — العلامات المرجعية (المخططات)، وجهات الصفحات، وإجراءات المستند. تتيح لك هذه إنشاء مستندات تفاعلية مع تنقل جدول المحتويات، روابط عبر الصفحات، ومشغلات JavaScript.

مخططات المستند (الإشارات المرجعية)

OutlineCollection يحتوي على شجرة العلامات المرجعية للمستند. كل OutlineItemCollection هو إدخال علامة مرجعية يحتوي على عنوان ووجهة.

using var doc = Document.Open(pdfBytes);

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

إنشاء إشارات مرجعية

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

GoToAction ينتقل إلى صفحة محددة ونوع ملاءمة داخل نفس المستند.

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

الإجراءات المسماة

NamedAction يُطلق أوامر عارض PDF المحددة مسبقًا مثل NextPage و PrevPage و FirstPage و LastPage.

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

إجراءات GoToRemote

GoToRemoteAction يفتح ملف PDF خارجي ويتنقل إلى صفحة محددة.

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

إطلاق الإجراءات

LaunchAction يفتح ملفًا خارجيًا (أي تنسيق) من رابط PDF.

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

مجموعات الوجهة

DestinationCollection يربط الوجهات المسماة بالصفحات، داعماً التنقل عبر الإشارات المتبادلة في المستندات الكبيرة.

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

نصائح وأفضل الممارسات

• أنشئ شجرة إشارة مرجعية تعكس تسلسل أقسام المستند الخاص بك لتسهيل التنقل.
• استخدم GoToAction مع FitType للتحكم في طريقة عرض الصفحة المستهدفة (ملاءمة العرض، ملاءمة الصفحة، إلخ).
• الإجراءات المسماة تعتمد على عارض المستند — التزم بالأسماء القياسية (NextPage, PrevPage, FirstPage, LastPage).
• لروابط عبر المستندات، استخدم GoToRemoteAction بدلاً من إجراءات URI التي تشير إلى ملفات PDF.
• مجموعة الإجراءات على الصفحة تتيح لك إضافة إجراءات متعددة تُنفّذ عند فتح الصفحة.

مشكلات شائعة

الأسئلة المتكررة

كيف أنشئ جدول محتويات؟

أنشئ OutlineItemCollection إدخالات لكل قسم، كل منها مع
GoToAction يستهدف الصفحة الأولى للقسم.

هل يمكنني تعشيق العلامات المرجعية؟

نعم. أضف إدخالات OutlineItemCollection الفرعية إلى إشارة مرجعية أصلية لإنشاء مخطط هرمي.

ما أنواع الملاءمة المتاحة لإجراءات GoTo؟

Fit، FitH (ملاءمة العرض)، FitV (ملاءمة الارتفاع)، FitR (ملاءمة المستطيل)، وFitB (ملاءمة صندوق الحدود).

ملخص مرجع API

انظر أيضًا

• Aspose.PDF for .NET المنتج المؤسسي