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

إنشاء إشارات مرجعية لجميع الصفحات

لإنشاء إشارات مرجعية لجميع الصفحات، تحتاج إلى استخدام CreateBookmarks بدون أي معلمات. تتيح لك فئة PdfBookmarkEditor إنشاء إشارات مرجعية لجميع صفحات ملف PDF. أولاً، تحتاج إلى إنشاء كائن من فئة PdfBookmarkEditor وربط ملف PDF المدخل باستخدام طريقة BindPdf. ثم، يجب عليك استدعاء طريقة CreateBookmarks وحفظ ملف PDF الناتج باستخدام طريقة Save. يوضح لك المقتطف البرمجي التالي كيفية إنشاء إشارات مرجعية.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void CreateBookmarksOfAllPages()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdfFacades_Bookmarks();

    // Create PdfBookmarkEditor
    using (var bookmarkEditor = new Aspose.Pdf.Facades.PdfBookmarkEditor())
    {
        // Bind PDF document
        bookmarkEditor.BindPdf(dataDir + "CreateBookmarksAll.pdf");
        // Create bookmark of all pages
        bookmarkEditor.CreateBookmarks();
        // Save PDF document
        bookmarkEditor.Save(dataDir + "CreateBookmarksOfAllPages_out.pdf");
    }
} 

إنشاء إشارات مرجعية لجميع الصفحات مع الخصائص

تتيح لك فئة PdfBookmarkEditor إنشاء إشارات مرجعية لجميع صفحات ملف PDF وتحديد الخصائص (اللون، الغامق، المائل). يمكنك القيام بذلك بمساعدة طريقة CreateBookmarks. أولاً، تحتاج إلى إنشاء كائن من فئة PdfBookmarkEditor وربط ملف PDF المدخل باستخدام طريقة BindPdf. ثم، يجب عليك استدعاء طريقة CreateBookmarks وحفظ ملف PDF الناتج باستخدام طريقة Save. يوضح لك المقتطف البرمجي التالي كيفية إنشاء إشارات مرجعية لجميع الصفحات مع الخصائص.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void CreateBookmarksOfAllPagesWithProperties()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdfFacades_Bookmarks();

    // Create PdfBookmarkEditor
    using (var bookmarkEditor = new Aspose.Pdf.Facades.PdfBookmarkEditor())
    {
        // Bind PDF document
        bookmarkEditor.BindPdf(dataDir + "CreateBookmarks-PagesProperties.pdf");
        // Create bookmark of all pages
        bookmarkEditor.CreateBookmarks(System.Drawing.Color.Green, true, true);
        // Save PDF document
        bookmarkEditor.Save(dataDir + "CreateBookmarks-PagesProperties_out.pdf");
    }
}

إنشاء إشارة مرجعية لصفحة معينة

يمكنك إنشاء إشارة مرجعية لصفحة معينة في ملف PDF موجود باستخدام طريقة CreateBookmarkOfPage. تأخذ هذه الطريقة وسيطين: عنوان الإشارة المرجعية ورقم الصفحة. أولاً، تحتاج إلى إنشاء كائن من فئة PdfBookmarkEditor وربط ملف PDF المدخل باستخدام طريقة BindPdf. ثم، يجب عليك استدعاء طريقة CreateBookmarkOfPage وحفظ ملف PDF الناتج باستخدام طريقة Save. يوضح لك المقتطف البرمجي التالي كيفية إنشاء إشارة مرجعية لصفحة معينة.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void CreateBookmarkOfAParticularPage()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdfFacades_Bookmarks();

    // Create PdfBookmarkEditor
    using (var bookmarkEditor = new Aspose.Pdf.Facades.PdfBookmarkEditor())
    {
        // Bind PDF document
        bookmarkEditor.BindPdf(dataDir + "CreateBookmark-Page.pdf");
        // Create bookmark of a particular page
        bookmarkEditor.CreateBookmarkOfPage("Bookmark Name", 2);
        // Save PDF document
        bookmarkEditor.Save(dataDir + "CreateBookmark-Page_out.pdf");
    }
}

إنشاء إشارات مرجعية لنطاق من الصفحات

تتيح لك فئة PdfBookmarkEditor إنشاء إشارات مرجعية لنطاق من الصفحات. يمكنك استخدام طريقة CreateBookmarkOfPage مع وسيطين: قائمة الإشارات المرجعية (قائمة عناوين الإشارات المرجعية) وقائمة الصفحات (قائمة الصفحات التي تريد إنشاء إشارات مرجعية لها). أولاً، تحتاج إلى إنشاء كائن من فئة PdfBookmarkEditor وربط ملف PDF المدخل باستخدام طريقة BindPdf. ثم، يجب عليك استدعاء طريقة CreateBookmarkOfPage وحفظ ملف PDF الناتج باستخدام طريقة Save. يوضح لك المقتطف البرمجي التالي كيفية إنشاء إشارات مرجعية لنطاق من الصفحات.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void CreateBookmarksOfARangeOfPages()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdfFacades_Bookmarks();

    // Create PdfBookmarkEditor
    using (var bookmarkEditor = new Aspose.Pdf.Facades.PdfBookmarkEditor())
    {
        // Bind PDF document
        bookmarkEditor.BindPdf(dataDir + "CreateBookmark-Page.pdf");
        // Bookmark name list
        string[] bookmarkList = { "First" };
        // Page list
        int[] pageList = { 1 };
        // Create bookmark of a range of pages
        bookmarkEditor.CreateBookmarkOfPage(bookmarkList, pageList);
        // Save PDF document
        bookmarkEditor.Save(dataDir + "CreateBookmarkPageRange_out.pdf");
    }
}

إضافة إشارة مرجعية في ملف PDF موجود

يمكنك إضافة إشارة مرجعية في ملف PDF موجود باستخدام فئة PdfBookmarkEditor. لإنشاء الإشارة المرجعية، تحتاج إلى إنشاء كائن Bookmark وتعيين الخصائص المطلوبة للإشارة المرجعية. بعد ذلك، تحتاج إلى تمرير كائن Bookmark إلى طريقة CreateBookmarks من فئة PdfBookmarkEditor. أخيرًا، تحتاج إلى حفظ ملف PDF المحدث باستخدام طريقة Save. يوضح لك المقتطف البرمجي التالي كيفية إضافة الإشارة المرجعية في ملف PDF موجود.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddBookmarkInAnExistingPdfFile()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdfFacades_Bookmarks();
    // Create bookmark
    var bookmark = new Aspose.Pdf.Facades.Bookmark();
    bookmark.PageNumber = 1;
    bookmark.Title = "New Bookmark";
    // Create PdfBookmarkEditor
    using (var bookmarkEditor = new Aspose.Pdf.Facades.PdfBookmarkEditor())
    {
        // Bind PDF document
        bookmarkEditor.BindPdf(dataDir + "AddBookmark.pdf");
        // Create bookmarks
        bookmarkEditor.CreateBookmarks(bookmark);
        // Save PDF document
        bookmarkEditor.Save(dataDir + "AddBookmark_out.pdf");
    }
}

إضافة إشارة مرجعية فرعية في ملف PDF موجود

يمكنك إضافة إشارات مرجعية فرعية في ملف PDF موجود باستخدام فئة PdfBookmarkEditor. لإضافة إشارات مرجعية فرعية، تحتاج إلى إنشاء كائنات Bookmark. يمكنك إضافة كائنات Bookmark الفردية إلى كائن Bookmarks. تحتاج أيضًا إلى إنشاء كائن Bookmark وتعيين خاصية ChildItem إلى كائن Bookmarks. ثم تحتاج إلى تمرير هذا الكائن Bookmark مع ChildItem إلى طريقة CreateBookmarks. أخيرًا، تحتاج إلى حفظ ملف PDF المحدث باستخدام طريقة Save من فئة PdfBookmarkEditor. يوضح لك المقتطف البرمجي التالي كيفية إضافة إشارات مرجعية فرعية في ملف PDF موجود.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddChildBookmarkInAnExistingPdfFile()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdfFacades_Bookmarks();
    // Create bookmarks
    var bookmarks = new Aspose.Pdf.Facades.Bookmarks();
    var childBookmark1 = new Aspose.Pdf.Facades.Bookmark();
    childBookmark1.PageNumber = 1;
    childBookmark1.Title = "First Child";
    var childBookmark2 = new Aspose.Pdf.Facades.Bookmark();
    childBookmark2.PageNumber = 2;
    childBookmark2.Title = "Second Child";
    bookmarks.Add(childBookmark1);
    bookmarks.Add(childBookmark2);
    var bookmark = new Aspose.Pdf.Facades.Bookmark();
    bookmark.Action = "GoTo";
    bookmark.PageNumber = 1;
    bookmark.Title = "Parent";
    bookmark.ChildItems = bookmarks;
    // Create PdfBookmarkEditor class
    using (var bookmarkEditor = new Aspose.Pdf.Facades.PdfBookmarkEditor())
    {
        // Bind PDF document
        bookmarkEditor.BindPdf(dataDir + "AddChildBookmark.pdf");
        // Create bookmarks
        bookmarkEditor.CreateBookmarks(bookmark);
        // Save PDF document
        bookmarkEditor.Save(dataDir + "AddChildBookmark_out.pdf");
    }
}