استعراض عام لبناء الوثائق
DocumentBuilder هو الطبقة القوية التي ترتبط مع Document ويمكّنك من بناء وثائق دينامية من الصفر أو إضافة عناصر جديدة إلى واحدة قائمة.
DocumentBuilder (ب) توفر أساليب لإدراج النص، وصناديق التفتيش، والأشياء الأولية، والفقرات، والقوائم، والجداول، والصور، وعناصر المحتوى الأخرى. إنه يسمح لك بتحديد صور أو فقرات أو شكل أجزاء، والقيام بعمليات أخرى.
بناء الوثائق أو Aspose.Words DOM
DocumentBuilder تكمل الفصول والأساليب المتاحة في Aspose.Words Document Object Model )أ(DOM() تبسيط مهام بناء الوثائق الأكثر شيوعا. هذا هو، يمكنك خلق وتعديل محتوى الوثائق من خلال Aspose.Words DOMالذي يتطلب فهماً جيداً لهيكل الأشجار، وإستعمال “الوثيقة” The DocumentBuilder هو “مسلسل” للمجمع Document الهيكل الذي يُمكِنُك أَنْ تُدخلَ بسرعة وسهولة المحتوىَ والشكلَ.
العمليات التي يمكن الاضطلاع بها 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 وربطه مع Document هدف تخلقين حالة جديدة DocumentBuilder عن طريق الاتصال بتشييده وإرساله إلى Document شيء لإرتباطه بالبني
إدخال نص، تمرر سلسلة النصوص التي تحتاج إلى إدراجها في الوثيقة Write طريقة
ويبين المثال الرمزي التالي كيفية وضع وثيقة بسيطة باستخدام مبني الوثائق.
نشر الوثيقة
The Font وتُعرّف الممتلكات شكل النصوص. ويحتوي هذا الجسم على خصائص مختلفة (الاسم العنيف، وحجم الفونت، واللون، وما إلى ذلك). Some important font attributes are also represented by DocumentBuilder العقارات للسماح لك بالدخول مباشرة هذه هي Font.Bold, Font.Italic, و Font.Underline ممتلكات بوليان
ويبيّن المثال الرمزي التالي كيفية إدخال نص شكلي باستخدام DocumentBuilder:
- Font ويحدد الشكل الذي سيطبق على جميع النصوص الواردة من الموقع الحالي في الوثيقة فصاعدا.
- ParagraphFormat ويحدد صيغة الفقرة للصيغة الحالية وجميع الفقرات التي ستدرج.
- PageSetup يحدد الصفحات وخصائص الأقسام للقسم الحالي والجزء بأكمله الذي سيدرج.
- CellFormat و RowFormat (ب) تحديد خصائص الشكل التي ستطبق على خلايا الجداول والعدود من الموقع الحالي في الوثيقة فصاعداً.
في هذه الحالة، “مباشرة” يعني الموقع، الفقرة، القسم، الخلية، أو الصف الذي يكون فيه الشعار.