نظرة عامة على منشئ المستندات
DocumentBuilder هي فئة قوية ترتبط بـ Document وتمكنك من إنشاء مستندات ديناميكية من البداية أو إضافة عناصر جديدة إلى عنصر موجود.
DocumentBuilder
منشئ المستندات أو Aspose.Words DOM
DocumentBuilder
العمليات الممكنة مع DocumentBuilder ممكنة أيضا عند استخدام فئات Aspose.Words DOM مباشرة. ومع ذلك، فإن استخدام فئات Aspose.Words DOM بشكل مباشر يتطلب عادة أسطر من التعليمات البرمجية أكثر من استخدام DocumentBuilder.
التنقل في المستندات
يعتمد التنقل في المستند على مفهوم المؤشر الافتراضي، والذي يمكنك من خلاله الانتقال إلى موقع آخر في المستند باستخدام طرق DocumentBuilder.MoveToXXX مختلفة مثل MoveToDocumentStart و MoveToField. يشير هذا المؤشر الظاهري إلى مكان إدراج النص عند استدعاء الطرق Write, Writeln, InsertBreak, وغيرها.
يوضح مثال الكود التالي كيفية الانتقال إلى إشارة مرجعية:
بناء الوثائق وتعديلها
Aspose.Words API يوفر العديد من الفئات المسؤولة عن تنسيق العناصر المختلفة للمستند. تقوم كل فئة بتغليف خصائص التنسيق المتعلقة بعنصر مستند معين، مثل النص والفقرة والقسم وغيرها. على سبيل المثال، تمثل فئة Font خصائص تنسيق الأحرف، وتمثل فئة ParagraphFormat خصائص تنسيق الفقرة، وهكذا. يتم إرجاع كائنات هذه الفئات بواسطة خصائص DocumentBuilder المقابلة، والتي لها نفس أسماء الفئات. لذلك، يمكنك الوصول إليها وتعيين التنسيق المطلوب أثناء إنشاء المستند.
يمكنك أيضا إدراج نص وخانة اختيار وكائن أولي وصور وإشارات مرجعية وحقول نماذج وعناصر مستندات أخرى في موضع المؤشر باستخدام طريقة Write أو أي من طرق DocumentBuilder.InsertXXX، مثل InsertField و InsertHtml وطرق مماثلة.
دعونا نرى كيفية إنشاء مستند بسيط باستخدام DocumentBuilder.
إنشاء مستند باستخدام DocumentBuilder
للبدء، تحتاج إلى إنشاء DocumentBuilder وربطه بكائن Document. يمكنك إنشاء مثيل جديد من DocumentBuilder عن طريق استدعاء المنشئ الخاص به وتمريره إلى كائن Document للتعلق بالباني.
لإدراج نص، مرر سلسلة النص التي تحتاج إلى إدراجها في المستند إلى طريقة Write.
يوضح مثال الكود التالي كيفية إنشاء مستند بسيط باستخدام أداة إنشاء المستندات.
حدد تنسيق المستند
تحدد الخاصية Font تنسيق النص. يحتوي هذا الكائن على سمات خط مختلفة (اسم الخط وحجم الخط واللون وما إلى ذلك). يتم تمثيل بعض سمات الخط المهمة أيضا بخصائص DocumentBuilder للسماح لك بالوصول إليها مباشرة. هذه هي الخصائص المنطقية Font.Bold و Font.Italic و Font.Underline.
يوضح مثال الكود التالي كيفية إدراج نص منسق باستخدام DocumentBuilder:
- Font يحدد تنسيق الحرف الذي سيتم تطبيقه على كل النص المدرج من الموضع الحالي في المستند فصاعدا.
- ParagraphFormat يحدد تنسيق الفقرة الحالية وجميع الفقرات المراد إدراجها.
- PageSetup يحدد خصائص الصفحة والقسم للقسم الحالي والقسم بأكمله الذي سيتم إدراجه.
- CellFormat و RowFormat حدد خصائص التنسيق التي سيتم تطبيقها على خلايا الجدول والصفوف من الموضع الحالي في المستند فصاعدا.
في هذه الحالة، تعني كلمة “تيار” الموضع أو الفقرة أو القسم أو الخلية أو الصف الذي يوجد فيه المؤشر.