تعيين خاصية التعليق التوضيحي في ملف PDF

مقدمة

غالبًا ما يتطلب إنشاء مستندات PDF احترافية وجذابة بصريًا إضافة تعليقات توضيحية تلفت الانتباه إلى محتوى معين. أحد هذه التعليقات التوضيحية هو التعليق التوضيحي، والذي يشبه فقاعات الكلام التي تراها في القصص المصورة. يساعد التعليق التوضيحي في توضيح النص أو التأكيد عليه داخل ملف PDF. يجعل Aspose.PDF for .NET من السهل بشكل لا يصدق إضافة مثل هذه التعليقات التوضيحية إلى مستنداتك، وفي هذا البرنامج التعليمي، سنوضح كيفية تعيين خاصية التعليق التوضيحي في ملف PDF باستخدام هذه المكتبة القوية. سواء كنت مطورًا متمرسًا أو مبتدئًا، فبحلول نهاية هذا الدليل، سيكون لديك فهم واضح لكيفية العمل مع التعليقات التوضيحية في ملفات PDF.

المتطلبات الأساسية

قبل أن نتعمق في الكود، دعنا نغطي الأساسيات التي تحتاجها للبدء.

  1. Aspose.PDF for .NET: تأكد من تثبيت مكتبة Aspose.PDF for .NET. يمكنك تنزيلها منهنا.
  2. IDE: بيئة تطوير مثل Visual Studio.
  3. .NET Framework: تأكد من تثبيت .NET على جهازك.
  4. الترخيص المؤقت: إذا كنت ترغب في تجربة الميزات الكاملة لـ Aspose.PDF دون قيود، فاحصل علىرخصة مؤقتة.

استيراد الحزم

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

using Aspose.Pdf.Annotations;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Text;

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

الخطوة 1: تهيئة مستند PDF

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

// المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENT DIRECTORY";

// تهيئة مستند PDF جديد
Document doc = new Document();

هنا، نقوم بإنشاء جديدDocument الكائن الذي سيعمل كملف PDF الخاص بنا.dataDir يتم تعيين المتغير على الدليل الذي تريد حفظ ملف PDF الخاص بك فيه بعد الانتهاء.

الخطوة 2: إضافة صفحة جديدة إلى المستند

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

//إضافة صفحة جديدة إلى المستند
Page page = doc.Pages.Add();

الPages.Add()يتم استخدام هذه الطريقة لإضافة صفحة جديدة إلىdoc الكائن. يتم تخزين الصفحة الجديدة فيpage متغير سنستخدمه لاحقًا عند إضافة التعليق التوضيحي.

الخطوة 3: تحديد المظهر الافتراضي

تتمتع التعليقات التوضيحية، مثل التعليقات التوضيحية، بمظهر مرئي يمكنك تخصيصه. في هذه الخطوة، سنحدد الشكل الذي ينبغي أن يبدو عليه النص داخل التعليقات التوضيحية.

// تحديد المظهر الافتراضي للتعليق التوضيحي
DefaultAppearance da = new DefaultAppearance();
da.TextColor = System.Drawing.Color.Red;
da.FontSize = 10;

نحن ننشئDefaultAppearance كائن يحدد لون النص وحجم الخط. هنا، سيكون النص باللون الأحمر، وحجم الخط مضبوط على 10. سيتم تطبيق هذا المظهر على تعليق التوضيح.

الخطوة 4: إنشاء التعليق النصي الحر

الآن حان الوقت لإنشاء التعليق التوضيحي الفعلي. التعليق التوضيحي النصي المجاني هو ما يسمح لنا بإضافة تعليق توضيحي بنص ونمط محددين.

// إنشاء FreeTextAnnotation مع تعليق توضيحي
FreeTextAnnotation fta = new FreeTextAnnotation(page, new Rectangle(422.25, 645.75, 583.5, 702.75), da);
fta.Intent = FreeTextIntent.FreeTextCallout;
fta.EndingStyle = LineEnding.OpenArrow;

نحن ننشئFreeTextAnnotation كائن بإحداثيات محددة، تحدد موقعه على الصفحة.Intent تم ضبطه علىFreeTextCallout ، مما يشير إلى أن هذا تعليق توضيحي.EndingStyle تم ضبطه علىOpenArrow، مما يعني أن خط التعليق سينتهي بسهم مفتوح.

الخطوة 5: تحديد نقاط خطوط التعليق

يحتوي التعليق التوضيحي على خط يشير إلى منطقة الاهتمام. هنا، سنحدد النقاط التي يتكون منها هذا الخط.

// تحديد النقاط لخط التعليق
fta.Callout = new Point[]
{
    new Point(428.25, 651.75), 
    new Point(462.75, 681.375), 
    new Point(474, 681.375)
};

الCallout الخاصية عبارة عن مجموعة منPoint الأشياء، كل منها يمثل إحداثيًا على الصفحة. تحدد هذه النقاط مسار خط التعليق، مما يمنحه مظهر فقاعة الكلام الكلاسيكية.

الخطوة 6: إضافة التعليقات التوضيحية إلى الصفحة

بعد إنشاء التعليقات التوضيحية وتكوينها، فإن الخطوة التالية هي إضافتها إلى الصفحة.

// أضف التعليق التوضيحي إلى الصفحة
page.Annotations.Add(fta);

الAnnotations.Add() تُستخدم هذه الطريقة لوضع التعليقات التوضيحية على الصفحة التي أنشأناها سابقًا. تعمل هذه الخطوة على “رسم” التعليقات التوضيحية على صفحة PDF بشكل فعال.

الخطوة 7: تعيين محتوى النص الغني

يمكن أن تتضمن التعليقات التوضيحية نصًا غنيًا، مما يسمح بتنسيق المحتوى داخل الفقاعة. دعنا نضيف بعض النصوص النموذجية.

// تعيين النص الغني للتعليق التوضيحي
fta.RichText = "<body xmlns=\"http://www.w3.org/1999/xhtml\" xmlns:xfa=\"http://www.xfa.org/schema/xfa-data/1.0/\" xfa:APIVersion=\"Acrobat:11.0.23\" xfa:spec=\"2.0.2\" style=\"color:#FF0000;font-weight:normal;font-style:normal;font-stretch:normal\"><p dir=\"ltr\"><span style=\"font-size:9.0pt;font-family:Helvetica\">هذه عينة</span></p></body>";

الRichText يتم تعيين الخاصية بمحتوى HTML. وهذا يسمح بالتنسيق التفصيلي داخل التعليق التوضيحي، مثل تحديد حجم الخط واللون والنمط.

الخطوة 8: احفظ مستند PDF

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

// حفظ المستند
doc.Save(dataDir + "SetCalloutProperty.pdf");

الSave() تحفظ الطريقة المستند في الدليل المحدد باسم الملف “SetCalloutProperty.pdf”. تختتم هذه الخطوة عملية إنشاء ملف PDF.

خاتمة

والآن لديك كل ما تحتاجه! لقد قمت للتو بإنشاء مستند PDF مع تعليق توضيحي باستخدام Aspose.PDF for .NET. يمكن أن يكون هذا التعليق التوضيحي مفيدًا بشكل لا يصدق لتسليط الضوء على أجزاء معينة من المستند أو شرحها. يوفر Aspose.PDF واجهة برمجة تطبيقات قوية تجعل معالجة PDF سهلة ومرنة. سواء كنت تضيف تعليقات توضيحية أو تحول المستندات أو تتعامل مع مهام PDF معقدة، فإن Aspose.PDF يوفر لك كل ما تحتاجه.

الأسئلة الشائعة

هل يمكنني تخصيص مظهر التعليق التوضيحي بشكل أكبر؟

بالتأكيد! يمكنك تخصيص جوانب مختلفة مثل لون الخط وسمكه وعائلة الخط ونمط النص.

هل من الممكن إضافة تعليقات توضيحية متعددة في صفحة واحدة؟

نعم، يمكنك إضافة عدد كبير من التعليقات التوضيحية حسب الحاجة عن طريق تكرار الخطوات لكل تعليق توضيحي.

كيف يمكنني تغيير موضع التعليق التوضيحي؟

قم ببساطة بتعديل الإحداثيات فيRectangle وCallout خصائص لإعادة وضع التعليق التوضيحي.

هل يمكنني إضافة أنواع أخرى من التعليقات التوضيحية باستخدام Aspose.PDF؟

نعم، يدعم Aspose.PDF أنواعًا مختلفة من التعليقات التوضيحية، بما في ذلك التمييزات والطوابع ومرفقات الملفات.

هل يقتصر محتوى النص الغني على HTML؟

الRichText تدعم الخاصية مجموعة فرعية من HTML، مما يسمح لك بتضمين نص مصمم وتنسيق أساسي.

تحرير الصفحة تعيين تنسيق التعليقات التوضيحية للنص مجانًا