تخصيص تنسيق PDF باستخدام iTextSharp

في هذا السياق، يتناول الكود المقدم استخدام مكتبة iTextSharp في إنشاء ملف PDF وتخصيص خصائص النص، حيث يتم التركيب بين النصوص والصور داخل المستند. يتم استخدام الخط “Times New Roman” لتنسيق النصوص، وذلك عبر تعيين خصائص الخط المراد لكائنات النص.

الكود يبدأ بتعريف متغير hw ككائن من النوع HTMLWorker في مكتبة iTextSharp، والذي يُستخدم لتحويل عناصر HTML إلى مكونات PDF. بعد ذلك، يتم فصل محتوى المرسلة إلى أجزاء باستخدام فاصل معين وتخزينه في مصفوفة content.

يتم إضافة المحتوى إلى الملف النهائي عبر فحص العناصر وإضافتها بشكل منفصل، حيث يتم تحديد موقع الصورة ومن ثم إضافتها إلى المستند باستخدام الأوامر المناسبة. يتم استخدام خصائص مثل Alignment لتحديد موقع الصورة في الصفحة (يميناً، يساراً، أو في الوسط).

ثم يتم استخدام كائن HTMLWorker لتحويل كل جزء من المحتوى (نص أو صورة) من تنسيق HTML إلى مكونات PDF. يتم إنهاء كل عنصر HTML بأمر EndElement("") ومن ثم يتم تحويل فاصل المحتوى إلى الـ PDF باستخدام hw.Parse(new StringReader(AppUtil.GetAppSettings(AppConfigKey.ReceiptLetterPDFSeparator))).

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

يُظهر الكود المُقدم استخدامًا فعّالًا لمكتبة iTextSharp في إنشاء ملف PDF مُخصص، حيث يُمكن للمطور أداء تعديلات دقيقة وشاملة على تنسيق المحتوى داخل الملف. دعنا نستكشف بعض التفاصيل الإضافية في الكود:

1. التحكم في الخطوط والنصوص:
   يتيح لك استخدام خط “Times New Roman” التحكم الكامل في تنسيق النصوص، حيث يمكن تعيين معلمات مثل حجم الخط، واللون، والخصائص الأخرى لتحقيق التنسيق المرغوب.

2. إدراج الصور:
   يتيح الكود إدراج صور داخل الملف النهائي، مما يعزز جاذبية المستند. يتم استخدام خصائص مثل Alignment لتحديد موقع الصورة على الصفحة بشكل دقيق.

3. فصل المحتوى:
   يتم فصل المحتوى إلى أجزاء باستخدام فاصل معين، مما يتيح للمطور تنظيم المحتوى بشكل هيكلي وفعال.

4. تكامل HTML و PDF:
   يستخدم كائن HTMLWorker لتحويل عناصر HTML إلى مكونات PDF، وهذا يوفر للمطور القدرة على استخدام تنسيق HTML المألوف له بدلاً من إعادة بناء التنسيق من الصفر.

5. القدرة على التكامل مع قواعد البيانات:
   يمكن للمطور توسيع الكود لتكامله مع قواعد البيانات، حيث يمكن إدراج المحتوى الديناميكي في المستند بسهولة.

6. التنسيق الأفقي والرأسي:
   يُظهر الكود استخدامًا لخصائص Alignment لتحديد توزيع الصور أفقياً (يمينًا ويسارًا) ورأسياً (في الوسط)، مما يسهم في إضافة تنوع إلى تخطيط الملف.

في الختام، يمثل هذا الكود نموذجًا ممتازًا لتوليد ملفات PDF مُخصصة بواسطة iTextSharp، حيث يتيح للمطورين إنشاء مستندات محترفة وجذابة بسهولة وكفاءة.