سطوح منطقی گره ها در یک سند

این مستندات گاهی اوقات به گروهی از کلاس های گره به عنوان متعلق به یک “سطح” در یک سند اشاره می کند، مانند “سطح بلوک”، “سطح خطی” (همچنین به عنوان “خط” شناخته می شود)، یا “سطح ردیف” گره ها. این سطوح در یک سند کاملا منطقی متمایز هستند و به طور صریح با ارث یا سایر روش های Aspose.Words DOM بیان نمی شوند. سطح گره برای توصیف مکان در درخت سند که گره معمولا در آن رخ می دهد استفاده می شود.

در مقاله قبلی، ما قبلا در مورد رابطه بین گره ها و این واقعیت صحبت کردیم که همه گره ها مجاز به فرزند هر گره نیستند. به عنوان مثال، سلول فقط می تواند یک کودک ردیف باشد، و یک ردیف فقط می تواند یک کودک جدول باشد، و غیره. این روابط همچنین برای تقسیم منطقی گره ها به سطوح در سند قابل استفاده است.

بخش های زیر سطوح منطقی گره ها را در Aspose.Words و کلاس هایی که به هر سطح تعلق دارند توصیف می کنند.

سطح منطقی سند و بخش

یک سند ورد شامل یک یا چند بخش است که توسط کلاس Section نشان داده شده و با شکاف های بخش جدا شده است. یک بخش می تواند اندازه صفحه، حاشیه ها، جهت گیری، تعداد ستون های متن و سر و پای صفحه خود را تعریف کند.

Document و بخش گره های سطح ساختار را دارند که در نمودار زیر نشان داده شده است.

یک بخش شامل متن اصلی و همچنین سرصفحه ها و پای صفحه های اول، جفت و عجیب است. این “جریان” های مختلف متن stories نامیده می شوند.

در Aspose.Words، گره Section شامل گره های داستان Body و HeaderFooter است. شیء Body متن اصلی را ذخیره می کند. اشیاء HeaderFooter متن را برای هر سر و پای صفحه ذخیره می کنند. متن هر داستان شامل پاراگراف ها و جداول است که به ترتیب توسط اشیاء Paragraph و Table سطح بلوک نشان داده شده است.

علاوه بر این، هر سند ورد می تواند شامل یک لغت نامه باشد که توسط گره GlossaryDocument در Aspose.Words نشان داده می شود. یک سند لغت نامه شامل ورودی های BuildingBlocks، AutoText و AutoCorrect است.

GlossaryDocument

سطح منطقی بلوک

گره های سطح بلوک نشان دهنده ظروف برای کنترل محتوا و محتوا هستند و می توانند در گره های کودک درخت سند در گره های زیر رخ دهند:

• بدن
• هدر
• فوتر
• یادداشت زیرنویس
• نظر دهید
• شکل
• GroupShape
• سلول
• StructuredDocumentTag

گره های سطح بلوک با کلاس های زیر نشان داده می شوند:

• Tables و Paragraphs که مهم ترین گره های سطح بلوک هستند
• نشانه های کتاب، که هم در سطح بلوک و هم در سطح خطی رخ می دهد
• StructuredDocumentTag که نشان دهنده نشانه گذاری سفارشی است و می تواند شامل کنترل محتوا و محتوا باشد

نمودار زیر عناصر سطح بلوک را نشان می دهد.

سطح منطقی درون خطی

گره های سطح خطی محتوای واقعی سند را نشان می دهند و می توانند در ظروف زیر قرار بگیرند:

• پاراگراف-رایج ترین ظرف
• SmartTag
• StructuredDocumentTag

عناصر سطح خطی توسط کلاس های زیر نشان داده می شوند:

• Run – اجراهای متن با فرمت متفاوت
• BookmarkStart و BookmarkEnd نشانگر نشانک ها هستند
• [CommentRangeStart]https://reference.aspose.com/words/java/com.aspose.words/comment/RangeStart), CommentRangeEnd، Comment و Footnote نشان دهنده ی یادداشت ها هستند
• FieldStart, FieldChar, FieldSeparator و FieldEnd که کاراکترهای فیلد را نشان می دهند، و FormField فیلد های ورد را نشان می دهند
• SpecialChar نشان دهنده کاراکترهای ویژه در سند است
• Shape و GroupShape شکل ها، نقاشی ها، تصاویر و غیره را نشان می دهند.
• SmartTag و StructuredDocumentTag نشان دهنده نشانه گذاری سفارشی است

نمودار زیر ساختار گره های سطح خطی را نشان می دهد.

اشکال در Microsoft Word شامل هنر اداری AutoShapes، جعبه های متن، تصاویر، OLE اشیاء و کنترل های ActiveX است که همه آنها با استفاده از کلاس Shape نشان داده شده اند. برخی از اشکال همچنین می توانند حاوی متن باشند، بنابراین گره های شکل در Aspose.Words می توانند شامل گره های سطح بلوک باشند.

اشکال را می توان با استفاده از گره های GroupShape در داخل یکدیگر گروه بندی کرد.

حاشیه ها و نظرات می توانند حاوی متن باشند، بنابراین گره های حاشیه و نظر در Aspose.Words می توانند شامل گره های سطح بلوک باشند.

جدول، ردیف و سطح گره سلولی

جدول شامل گره های ردیف ها و سلول ها است. عناصر جدول با کلاس های زیر نشان داده می شوند:

• Row نشان دهنده یک ردیف جدول است
• Cell نشان دهنده یک سلول جدول است
• StructuredDocumentTag نشان دهنده نشانه گذاری سفارشی

نمودار زیر ساختار گره جدول، ردیف و سطوح سلولی را نشان می دهد.