إضافة وحذف إشارة مرجعية باستخدام Python

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

تُحتفظ بالإشارات المرجعية في مجموعة OutlineItemCollection للكائن Document، وهي نفسها في مجموعة OutlineCollection.

لإضافة إشارة مرجعية إلى PDF:

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

يظهر لك المقتطف البرمجي التالي كيفية إضافة إشارة مرجعية في مستند PDF.

    import aspose.pdf as ap

    # افتح المستند
    document = ap.Document(input_pdf)

    # أنشئ كائن الإشارة المرجعية
    outline = ap.OutlineItemCollection(document.outlines)
    outline.title = "Test Bookmark"
    outline.italic = True
    outline.bold = True
    # حدد رقم صفحة الوجهة
    outline.action = ap.annotations.GoToAction(document.pages[1])
    # أضف الإشارة المرجعية إلى مجموعة الإشارات المرجعية في المستند.
    document.outlines.append(outline)

    # احفظ الناتج
    document.save(output_pdf)

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

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

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

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

يتم إنشاء الإشارة المرجعية الفرعية تمامًا مثل الإشارة المرجعية الرئيسية، كما هو موضح أعلاه، ولكن يتم إضافتها إلى مجموعة الإشارات المرجعية الرئيسية.

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

    import aspose.pdf as ap

    # افتح المستند
    document = ap.Document(input_pdf)

    # إنشاء كائن إشارة مرجعية رئيسية
    outline = ap.OutlineItemCollection(document.outlines)
    outline.title = "Parent Outline"
    outline.italic = True
    outline.bold = True

    # إنشاء كائن إشارة مرجعية فرعية
    childOutline = ap.OutlineItemCollection(document.outlines)
    childOutline.title = "Child Outline"
    childOutline.italic = True
    childOutline.bold = True

    # إضافة إشارة مرجعية فرعية في مجموعة الإشارات المرجعية الرئيسية
    outline.append(childOutline)
    # إضافة إشارة مرجعية رئيسية في مجموعة الإشارات المرجعية للمستند.
    document.outlines.append(outline)

    # حفظ المخرج
    document.save(output_pdf)

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

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

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

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

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

    import aspose.pdf as ap

    # فتح المستند
    document = ap.Document(input_pdf)

    # حذف جميع الإشارات المرجعية
    document.outlines.delete()

    # حفظ الملف المحدث
    document.save(output_pdf)

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

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

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

توفر فئة Document مجموعة OutlineCollection. تقوم طريقة delete() بحذف أي علامة مرجعية بعنوان يمرر إلى الطريقة.

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

    import aspose.pdf as ap

    # افتح المستند
    document = ap.Document(input_pdf)

    # حذف العلامة المرجعية المحددة بالعنوان
    document.outlines.delete("Child Outline")

    # حفظ الملف المحدث
    document.save(output_pdf)