المستويات المنطقية للعقد في المستند
تشير هذه الوثائق أحيانًا إلى مجموعة من فئات العقد على أنها تنتمي إلى “مستوى” في مستند، مثل “مستوى الكتلة” أو “المستوى المضمّن” (المعروف أيضًا باسم “المضمّن”) أو العقد “على مستوى الصف”.. يتم التمييز بين هذه المستويات في المستند بطريقة منطقية بحتة ولا يتم التعبير عنها صراحةً عن طريق الوراثة أو وسائل Aspose.Words DOM الأخرى. يتم استخدام مستوى العقدة لوصف المكان في شجرة المستندات حيث يمكن أن تحدث العقدة عادةً.
في المقالة السابقة، تحدثنا بالفعل عن العلاقة بين العقد وحقيقة أنه لا يُسمح لجميع العقد بأن تكون فرعًا لأي عقد. على سبيل المثال، يمكن أن تكون الخلية فرعًا لصف فقط، ويمكن أن يكون الصف فرعًا لجدول فقط، وهكذا. تنطبق هذه العلاقات أيضًا على التقسيم المنطقي للعقد إلى مستويات في المستند.
تصف الأقسام التالية المستويات المنطقية للعقد في Aspose.Words والفئات التي تنتمي إلى كل مستوى.
الوثيقة والقسم المستوى المنطقي
يتكون مستند Word من قسم واحد أو أكثر، ممثلة بفئة Section ومفصولة بفواصل أقسام. يمكن للقسم تحديد حجم الصفحة والهوامش والاتجاه وعدد أعمدة النص والرؤوس والتذييلات الخاصة به.
تحتوي العقد على مستوى Document وSection على البنية كما هو موضح في الرسم البياني التالي.
يحتوي القسم على النص الرئيسي، بالإضافة إلى الرؤوس والتذييلات للصفحات الأولى والزوجية والفردية. تسمى هذه “التدفقات” المختلفة للنص stories.
في Aspose.Words، تحتوي عقدة Section على عقد قصة Body وHeaderFooter. يقوم كائن Body بتخزين النص الرئيسي. تقوم كائنات HeaderFooter بتخزين النص لكل رأس وتذييل. يتكون نص أي قصة من فقرات وجداول، يتم تمثيلها على التوالي بواسطة كائنات Paragraph وTable على مستوى الكتلة.
بالإضافة إلى ذلك، يمكن أن يحتوي كل مستند Word على مسرد مصطلحات، والذي يتم تمثيله بواسطة عقدة GlossaryDocument في Aspose.Words. يحتوي مستند المسرد على إدخالات BuildingBlocks، وAutoText، وAutoCorrect.
يتضمن GlossaryDocument عقد BuildingBlock تمثل أنواعًا مختلفة من إدخالات مستند المسرد. يحتوي كل BuildingBlock على أقسام يمكن إدراجها وإزالتها ونسخها في المستندات.
كتلة المستوى المنطقي
تمثل العقد على مستوى الكتلة حاويات للمحتوى وعناصر تحكم المحتوى، ويمكن أن تحدث في العقد الفرعية لشجرة الوثيقة في العقد التالية:
- جسم
- رأس
- تذييل
- هامش
- تعليق
- شكل
- Groupالشكل
- خلية
- علامة الوثيقة المنظمة
يتم تمثيل العقد على مستوى الكتلة بالفئات التالية:
- Tables وParagraphs، وهما العقدتان الأكثر أهمية على مستوى الكتلة
- الإشارات المرجعية، والتي تحدث على مستوى الكتلة وعلى المستوى المضمن
- StructuredDocumentTag، والتي تمثل علامات مخصصة ويمكن أن تحتوي على كل من عناصر التحكم في المحتوى والمحتوى
يوضح الرسم البياني التالي عناصر مستوى الكتلة.
المستوى المنطقي المضمن
تمثل العقد ذات المستوى المضمن المحتوى الفعلي للمستند ويمكن تضمينها في الحاويات التالية:
- الفقرة – الحاوية الأكثر شيوعا
- SmartTag
- علامة الوثيقة المنظمة
يتم تمثيل عناصر المستوى المضمّن بالفئات التالية:
- Run - مجموعات من النص بتنسيق مختلف
- يمثل BookmarkStart وBookmarkEnd الإشارات المرجعية
- تمثل CommentRangeStart وCommentRangeEnd وComment وFootnote التعليقات التوضيحية
- FieldStart وFieldChar وFieldSeparator وFieldEnd التي تمثل أحرف الحقل، وFormField تمثل حقول Word
- يمثل SpecialChar أحرفًا خاصة في المستند
- يمثل Shape وGroupShape الأشكال والرسومات والصور وما إلى ذلك.
- تمثل SmartTag وStructuredDocumentTag ترميزًا مخصصًا
يوضح الرسم البياني التالي بنية العقد ذات المستوى المضمن.
تتضمن الأشكال في Microsoft Word الأشكال التلقائية لـ Office Art، ومربعات النص، والصور، وكائنات OLE، وعناصر تحكم ActiveX، والتي يتم تمثيلها جميعًا باستخدام فئة Shape
. يمكن أن تحتوي بعض الأشكال أيضًا على نص، لذلك يمكن أن تحتوي عقد الشكل في Aspose.Words على عقد على مستوى الكتلة.
يمكن تجميع الأشكال داخل بعضها البعض باستخدام عقد GroupShape.
مستوى عقدة الجدول والصف والخلية
يتكون الجدول من عقد من الصفوف والخلايا. يتم تمثيل عناصر الجدول بالفئات التالية:
يوضح الرسم التخطيطي التالي بنيات العقد لمستويات الجدول والصف والخلية.