Add TOC

مدير Documentize PDF لـ .NET هو مكون إضافي قوي مصمم لتعزيز تنظيم وتنقل مستندات PDF من خلال إنشاء جدول محتويات (TOC) ديناميكيًا. يبسط هذا المكون الإضافي عملية إضافة جداول المحتويات إلى ملفات PDF الخاصة بك، مما يجعل من السهل التنقل وإدارة المستندات.

كيفية إنشاء جدول محتويات لملف PDF

لإنشاء جدول محتويات في ملف PDF، اتبع الخطوات التالية:

  1. قم بإنشاء مثيل من TocOptions لتكوين إعدادات إنشاء جدول المحتويات.
  2. قم بتعيين عنوان باستخدام خاصية Title.
  3. قم بتصميم العناوين لجدول المحتويات باستخدام طريقة Headings.Add.
  4. أضف ملف PDF المدخل باستخدام طريقة AddInput.
  5. حدد ملف PDF الناتج مع جدول المحتويات باستخدام طريقة AddOutput.
  6. استدعِ طريقة AddTableOfContents لإنشاء جدول المحتويات.
 1// إنشاء كائن TocOptions لتعيين التعليمات  
 2var options = new TocOptions();  
 3// تعيين العنوان  
 4options.Title = "جدول محتوياتي";  
 5// تصميم العناوين  
 6options.Headings.Add(new TocHeading("المقدمة", 2));  
 7options.Headings.Add(new TocHeading("الفصل الأول", 3));  
 8options.Headings.Add(new TocHeading("الفصل الثاني", 4));  
 9options.Headings.Add(new TocHeading("الفصل الثالث", 5));  
10// إضافة مسار ملف الإدخال  
11options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));  
12// تعيين مسار الملف الناتج  
13options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));  
14// تنفيذ العملية  
15PdfManager.AddTableOfContents(options);  

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

يمكنك استخدام خاصية ‘GenerateBookmarks’ لإنشاء الإشارات المرجعية.

 1// إنشاء كائن TocOptions لتعيين التعليمات  
 2var options = new TocOptions();  
 3// تعيين العنوان  
 4options.Title = "جدول محتوياتي";  
 5// إنشاء روابط في الإشارات المرجعية  
 6options.GenerateBookmarks = true;  
 7// تصميم العناوين  
 8options.Headings.Add(new TocHeading("المقدمة", 2, false, 1));  
 9options.Headings.Add(new TocHeading("الفصل الأول", 3, true, 1));  
10options.Headings.Add(new TocHeading("الفصل الثاني", 4, true, 1));  
11options.Headings.Add(new TocHeading("مثال أ", 4, true, 2));  
12options.Headings.Add(new TocHeading("مثال ب", 4, true, 2));  
13options.Headings.Add(new TocHeading("مثال ج", 4, true, 2));  
14options.Headings.Add(new TocHeading("مثال د", 4, true, 2));  
15options.Headings.Add(new TocHeading("الفصل الثالث", 5, true, 1));  
16// إضافة مسار ملف الإدخال  
17options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));  
18// تعيين مسار الملف الناتج  
19options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));  
20// تنفيذ العملية  
21PdfManager.AddTableOfContents(options);  

كيفية الحصول على النتائج كدفق

 1// إنشاء كائن TocOptions لتعيين التعليمات  
 2var options = new TocOptions();  
 3// تعيين العنوان  
 4options.Title = "جدول محتوياتي";  
 5// تصميم العناوين  
 6options.Headings.Add(new TocHeading("المقدمة", 2, false, 1));  
 7// إضافة مسار ملف الإدخال  
 8options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));  
 9// تعيين دفق الناتج  
10var outputStream = new MemoryStream();  
11options.AddOutput(new StreamDataSource(outputStream));  
12options.CloseOutputStreams = false;  
13// تنفيذ العملية  
14PdfManager.AddTableOfContents(options);  

تخصيص عنوان جدول المحتويات

يمكنك تخصيص عنوان جدول المحتويات عن طريق تعديل فئة TocHeading. على سبيل المثال، يمكنك استخدام ‘GenerateNumbering’ أو القيام بذلك يدويًا.
تستخدم خاصية ‘PageNumber’ للروابط على الصفحات. يمكنك أيضًا استخدام خاصية Level.

 1  
 2var heading = new TocHeading();  
 3heading.Text = "مقدمة";  
 4heading.PageNumber = 5;  
 5heading.GenerateNumbering = true;  
 6heading.Level = 2;  
 7
 8var tocOptions = new TocOptions();  
 9options.Headings.Add(heading);  
10// إضافة ملفات الإدخال والإخراج  
11tocOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));  
12tocOptions.AddOutput(new FileDataSource(@"C:\Samples\output_with_toc.pdf"));  
13
14// إنشاء جدول المحتويات مع الخيارات المخصصة  
15PdfManager.AddTableOfContents(tocOptions);  

المميزات الرئيسية:

  • إنشاء جدول محتويات ديناميكي: إنشاء جدول محتويات لأي ملف PDF مع إدخالات تم إنشاؤها تلقائيًا بناءً على العناوين أو الإشارات المرجعية.
  • تخصيص: التحكم في مظهر وهيكل جدول المحتويات، بما في ذلك الأنماط، والتنسيق، ومستويات العمق.
  • تدفق عمل فعال: تقليل الوقت المستغرق في إنشاء جداول المحتويات يدويًا، وخاصة للمستندات الكبيرة أو المعقدة.
 عربي