نظرة عامة على منشئ المستندات
DocumentBuilder هي فئة قوية ترتبط بـ Document وتمكنك من إنشاء مستندات ديناميكية من البداية أو إضافة عناصر جديدة إلى مستند موجود.
يوفر DocumentBuilder طرقًا لإدراج النص ومربعات الاختيار وكائنات ole والفقرات والقوائم والجداول والصور وعناصر المحتوى الأخرى. يسمح لك بتحديد الخطوط وتنسيق الفقرة أو القسم وإجراء عمليات أخرى.
منشئ المستندات أو Aspose.Words DOM
يكمل DocumentBuilder الفئات والأساليب المتوفرة في Aspose.Words Document Object Model (DOM) لتبسيط مهام إنشاء المستندات الأكثر شيوعًا. أي أنه يمكنك إنشاء وتعديل محتوى المستندات من خلال Aspose.Words DOM، الأمر الذي يتطلب فهمًا جيدًا لبنية الشجرة، واستخدام DocumentBuilder. يعد DocumentBuilder “واجهة” لبنية Document المعقدة التي تسمح لك بإدراج المحتوى والتنسيق بسرعة وسهولة.
العمليات الممكنة باستخدام DocumentBuilder ممكنة أيضًا عند استخدام فئات Aspose.Words DOM مباشرة. ومع ذلك، عادةً ما يتطلب استخدام فئات Aspose.Words DOM مباشرةً سطورًا من التعليمات البرمجية أكثر من استخدام DocumentBuilder.
التنقل في المستندات
يعتمد التنقل في المستند على مفهوم المؤشر الافتراضي، الذي يمكنك من خلاله الانتقال إلى موقع آخر في المستند باستخدام طرق DocumentBuilder.move_to_XXX المختلفة مثل move_to_document_start وmove_to_field. يشير هذا المؤشر الافتراضي إلى المكان الذي سيتم إدراج النص فيه عند استدعاء الطرق write وwriteln وinsert_break وغيرها. راجع المقالة التالية “التنقل باستخدام المؤشر” لمعرفة المزيد حول المؤشر الافتراضي.
يوضح مثال التعليمات البرمجية التالي كيفية الانتقال إلى إشارة مرجعية:
بناء الوثيقة وتعديلها
يوفر Aspose.Words API عدة فئات مسؤولة عن تنسيق العناصر المختلفة للمستند. تحتوي كل فئة على خصائص التنسيق المتعلقة بعنصر معين في المستند، مثل النص والفقرة والقسم وغيرها. على سبيل المثال، تمثل فئة Font خصائص تنسيق الأحرف، وتمثل فئة ParagraphFormat خصائص تنسيق الفقرة، وهكذا. يتم إرجاع كائنات هذه الفئات بواسطة خصائص DocumentBuilder المقابلة، والتي لها نفس أسماء الفئات. لذلك، يمكنك الوصول إليها وتعيين التنسيق المطلوب أثناء إنشاء المستند.
يمكنك أيضًا إدراج نص ومربع اختيار وكائن أولي وصور وإشارات مرجعية وحقول نموذج وعناصر مستند أخرى في موضع المؤشر باستخدام طريقة Write أو أي من طرق DocumentBuilder.insert_XXX، مثل insert_field وinsert_html والطرق المشابهة.
دعونا نرى كيفية إنشاء مستند بسيط باستخدام DocumentBuilder.
إنشاء مستند باستخدام DocumentBuilder
للبدء، تحتاج إلى إنشاء DocumentBuilder وربطه بكائن Document. يمكنك إنشاء مثيل جديد لـ DocumentBuilder عن طريق استدعاء منشئه وتمريره إلى كائن Document لإرفاقه بالمنشئ.
لإدراج نص، قم بتمرير سلسلة النص التي تحتاج إلى إدراجها في المستند إلى طريقة write.
يوضح مثال التعليمات البرمجية التالي كيفية إنشاء مستند بسيط باستخدام منشئ المستندات.
تحديد تنسيق المستند
تحدد الخاصية font تنسيق النص. يحتوي هذا الكائن على سمات خط مختلفة (اسم الخط وحجم الخط واللون وما إلى ذلك). يتم أيضًا تمثيل بعض سمات الخط المهمة بواسطة خصائص DocumentBuilder للسماح لك بالوصول إليها مباشرةً. هذه هي خصائص Font.bold وFont.italic وFont.underline المنطقية.
يوضح مثال التعليمات البرمجية التالي كيفية إدراج نص منسق باستخدام DocumentBuilder:
- يحدد font تنسيق الأحرف الذي سيتم تطبيقه على كل النص المدرج من الموضع الحالي في المستند فصاعدًا.
- يحدد paragraph_format تنسيق الفقرة الحالية وجميع الفقرات التي سيتم إدراجها.
- يحدد page_setup خصائص الصفحة والقسم للقسم الحالي والقسم بأكمله الذي سيتم إدراجه.
- يحدد cell_format وrow_format خصائص التنسيق التي سيتم تطبيقها على خلايا وصفوف الجدول بدءًا من الموضع الحالي في المستند فصاعدًا.
في هذه الحالة، تعني كلمة “الحالي” الموضع أو الفقرة أو القسم أو الخلية أو الصف الذي يوجد به المؤشر.