نظرة عامة على منشئ المستندات
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 المقابلة، والتي لها نفس أسماء الفئات. لذلك، يمكنك الوصول إليها وتعيين التنسيق المطلوب أثناء إنشاء المستند.
يمكنك أيضا إدراج نص، checkbox، كائن أولي، صور، إشارات مرجعية، حقول نموذج، وعناصر مستند أخرى في موضع المؤشر باستخدام طريقة 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 حدد خصائص التنسيق التي سيتم تطبيقها على خلايا الجدول والصفوف من الموضع الحالي في المستند فصاعدا.
في هذه الحالة، تعني كلمة “تيار” الموضع أو الفقرة أو القسم أو الخلية أو الصف الذي يوجد فيه المؤشر.