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

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

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

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

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

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

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

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

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

علاوه بر این، هر سند Word می‌تواند شامل یک واژه‌نامه باشد که توسط گره GlossaryDocument در Aspose.Words نشان داده می‌شود. یک سند واژه نامه حاوی building_blocks BuildingBlockType.AUTO_TEXT و ورودی های BuildingBlockType.AUTO_CORRECT است.

GlossaryDocument شامل گره های BuildingBlock است که انواع مختلفی از مدخل های سند واژه نامه را نشان می دهد. هر BuildingBlock شامل بخش هایی است که می توان آنها را درج، حذف و در اسناد کپی کرد.

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

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

• Body
• Header
• Footer
• Footnote
• Comment
• Shape
• GroupShape
• Cell
• StructuredDocumentTag

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

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

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

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

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

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

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

• Run - اجرای متن با فرمت متفاوت
• BookmarkStart و BookmarkEnd نشان دهنده نشانک ها هستند
• CommentRangeStart، CommentRangeEnd، Comment و Footnote حاشیه نویسی را نشان می دهند
• FieldStart، FieldChar، FieldSeparator و FieldEnd که کاراکترهای فیلد را نشان می دهند و FormField نشان دهنده فیلدهای Word است
• SpecialChar نشان دهنده کاراکترهای خاص در سند است
• Shape و GroupShape اشکال، نقاشی ها، تصاویر و غیره را نشان می دهند.
• SmartTag و StructuredDocumentTag نشانه گذاری سفارشی را نشان می دهند

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

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

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

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

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

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

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

نمودار زیر ساختار گره‌های سطوح Table، Row و Cell را نشان می‌دهد.