نظرة عامة على منشئ المستندات

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: