إضافة وحذف إشارة مرجعية

يعمل الجزء التالي من الكود أيضًا مع مكتبة Aspose.PDF.Drawing.

إضافة إشارة مرجعية إلى مستند PDF

تُحفظ الإشارات المرجعية في مجموعة OutlineItemCollection الخاصة بكائن الوثيقة، وهي ضمن مجموعة OutlineCollection.

لإضافة إشارة مرجعية إلى مستند PDF:

  1. افتح مستند PDF باستخدام كائن Document.
  2. قم بإنشاء إشارة مرجعية وحدد خصائصها.
  3. أضف مجموعة OutlineItemCollection إلى مجموعة العناوين.

يوضح الجزء التالي من الكود كيفية إضافة إشارة مرجعية في مستند PDF.

// للحصول على أمثلة كاملة وملفات البيانات، يرجى زيارة https://github.com/aspose-pdf/Aspose.PDF-for-.NET
// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_AsposePdf_Bookmarks();

// فتح المستند
Document pdfDocument = new Document(dataDir + "AddBookmark.pdf");

// إنشاء كائن الإشارة المرجعية
OutlineItemCollection pdfOutline = new OutlineItemCollection(pdfDocument.Outlines);
pdfOutline.Title = "Test Outline";
pdfOutline.Italic = true;
pdfOutline.Bold = true;
// تحديد رقم صفحة الوجهة
pdfOutline.Action = new GoToAction(pdfDocument.Pages[1]);
// إضافة الإشارة المرجعية في مجموعة عناوين الوثيقة.
pdfDocument.Outlines.Add(pdfOutline);

dataDir = dataDir + "AddBookmark_out.pdf";
// حفظ الناتج
pdfDocument.Save(dataDir);

إضافة إشارة مرجعية فرعية إلى مستند PDF

يمكن تداخل الإشارات المرجعية، مما يشير إلى علاقة تسلسلية بين الإشارات المرجعية الأبوية والفرعية. يشرح هذا المقال كيفية إضافة إشارة مرجعية فرعية، أي إشارة مرجعية من المستوى الثاني، إلى ملف PDF.

لإضافة إشارة مرجعية فرعية إلى ملف PDF، أولاً أضف إشارة مرجعية أبوية:

  1. افتح مستندًا.
  2. أضف إشارة مرجعية إلى OutlineItemCollection، مع تحديد خصائصها.
  3. أضف مجموعة OutlineItemCollection إلى مجموعة OutlineCollection الخاصة بكائن المستند.

تُنشأ الإشارة المرجعية الفرعية بنفس طريقة الإشارة المرجعية الأبوية، كما هو موضح أعلاه، لكن يتم إضافتها إلى مجموعة الإشارات المرجعية للإشارة الأبوية

تظهر الأجزاء التالية من الكود كيفية إضافة إشارة مرجعية فرعية إلى مستند PDF.

// للحصول على أمثلة كاملة وملفات بيانات، يرجى الذهاب إلى https://github.com/aspose-pdf/Aspose.PDF-for-.NET
// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_AsposePdf_Bookmarks();

// فتح المستند
Document pdfDocument = new Document(dataDir + "AddChildBookmark.pdf");

// إنشاء كائن إشارة مرجعية أبوية
OutlineItemCollection pdfOutline = new OutlineItemCollection(pdfDocument.Outlines);
pdfOutline.Title = "Parent Outline";
pdfOutline.Italic = true;
pdfOutline.Bold = true;

// إنشاء كائن إشارة مرجعية فرعية
OutlineItemCollection pdfChildOutline = new OutlineItemCollection(pdfDocument.Outlines);
pdfChildOutline.Title = "Child Outline";
pdfChildOutline.Italic = true;
pdfChildOutline.Bold = true;

// إضافة الإشارة المرجعية الفرعية في مجموعة الإشارة الأبوية
pdfOutline.Add(pdfChildOutline);
// إضافة الإشارة المرجعية الأبوية في مجموعة الإشارات المرجعية للمستند.
pdfDocument.Outlines.Add(pdfOutline);

dataDir = dataDir + "AddChildBookmark_out.pdf";
// حفظ الناتج
pdfDocument.Save(dataDir);

حذف جميع العلامات المرجعية من مستند PDF

جميع العلامات المرجعية في ملف PDF موجودة في مجموعة OutlineCollection. يشرح هذا المقال كيفية حذف جميع العلامات المرجعية من ملف PDF.

لحذف جميع العلامات المرجعية من ملف PDF:

  1. استدعاء طريقة الحذف لمجموعة OutlineCollection.
  2. حفظ الملف المعدل باستخدام طريقة Save لكائن Document.

تظهر الأجزاء التالية من الشفرة كيفية حذف جميع العلامات المرجعية من مستند PDF.

// للأمثلة الكاملة وملفات البيانات، يرجى الذهاب إلى https://github.com/aspose-pdf/Aspose.PDF-for-.NET
// مسار دليل المستندات.
string dataDir = RunExamples.GetDataDir_AsposePdf_Bookmarks();

// فتح المستند
Document pdfDocument = new Document(dataDir + "DeleteAllBookmarks.pdf");

// حذف جميع العلامات المرجعية
pdfDocument.Outlines.Delete();

dataDir = dataDir + "DeleteAllBookmarks_out.pdf";
// حفظ الملف المحدث
pdfDocument.Save(dataDir);

حذف علامة مرجعية معينة من مستند PDF

لحذف علامة مرجعية معينة من ملف PDF:

  1. قم بتمرير عنوان العلامة المرجعية كمعامل إلى طريقة حذف مجموعة OutlineCollection.
  2. ثم احفظ الملف المُحدث باستخدام طريقة حفظ الكائن Document.

توفر فئة Document مجموعة OutlineCollection. تقوم طريقة Delete بإزالة أي علامة مرجعية يتم تمرير عنوانها إلى الطريقة.

توضح أجزاء الكود التالية كيفية حذف علامة مرجعية معينة من مستند PDF.

// للحصول على أمثلة كاملة وملفات البيانات، الرجاء التوجه إلى https://github.com/aspose-pdf/Aspose.PDF-for-.NET
// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_AsposePdf_Bookmarks();

// فتح المستند
Document pdfDocument = new Document(dataDir + "DeleteParticularBookmark.pdf");

// حذف علامة مرجعية معينة بالعنوان
pdfDocument.Outlines.Delete("Child Outline");

// حفظ الملف المُحدث
pdfDocument.Save(dataDir + "DeleteParticularBookmark_out.pdf");