کار با بخش ها
گاهی اوقات شما یک سند می خواهید که در تمام صفحات قالب بندی یکسان نداشته باشد. به عنوان مثال، ممکن است لازم باشد فرمت های شماره صفحه را تغییر دهید، اندازه و جهت گیری صفحه متفاوت داشته باشید یا صفحه سند اول را به عنوان صفحه جلد بدون هیچ شماره گذاری داشته باشید. شما می توانید این کار را با بخش ها انجام دهید.
بخش ها گره های سطحی هستند که سر و پای صفحه، جهت گیری، ستون ها، حاشیه ها، قالب بندی شماره صفحه و دیگران را کنترل می کنند.
Aspose.Words به شما اجازه می دهد تا بخش ها را مدیریت کنید، یک سند را به بخش ها تقسیم کنید و تغییرات قالب بندی را که فقط برای یک بخش خاص اعمال می شود، انجام دهید. Aspose.Words اطلاعات مربوط به قالب بندی بخش مانند سر و پای صفحه، تنظیم صفحه و تنظیمات ستون را در بخش break ذخیره می کند.
در این مقاله نحوه کار با بخش ها و وقفه های بخش توضیح داده شده است.
چه بخش و بخش شکستن است
بخش های سند توسط کلاس های Section و SectionCollection نشان داده می شوند. اشیاء بخش فرزندان فوری گره Document هستند و می توانند از طریق ویژگی Sections دسترسی پیدا کنند. شما می توانید این گره ها را با استفاده از برخی روش ها مانند Remove, Add, IndexOf, و دیگران.
Section break گزینه ای است که صفحات سند را به بخش هایی با طرح های قابل تنظیم تقسیم می کند.
انواع شکستن بخش
Aspose.Words اجازه می دهد تا شما را به تقسیم و فرمت اسناد با استفاده از بخش های مختلف شکستن BreakType شمارش:
- SectionBreakContinuous
- SectionBreakNewColumn
- SectionBreakNewPage
- SectionBreakEvenPage
- SectionBreakOddPage
همچنین می توانید از SectionStart enumeration برای انتخاب نوع break که فقط برای بخش اول اعمال می شود استفاده کنید مانند NewColumn, NewPage, EvenPage, و OddPage.
مدیریت یک بخش
از آنجا که یک بخش یک گره ترکیبی عادی است، کل دستکاری گره API می تواند برای دستکاری بخش ها استفاده شود: برای اضافه کردن، حذف و سایر عملیات در بخش ها. شما می توانید در مورد گره ها در مقاله بیشتر بخوانید Aspose.Words مدل شیء سند (DOM).
از طرف دیگر، شما همچنین می توانید از DocumentBuilder API برای کار با بخش ها استفاده کنید. در این مقاله، ما بر روی این روش خاص کار با بخش ها تمرکز خواهیم کرد.
یک شکاف بخش را وارد یا حذف کنید
Aspose.Words به شما اجازه می دهد تا یک بخش را با استفاده از روش InsertBreak به متن وارد کنید.
مثال کد زیر نشان می دهد که چگونه یک بخش را وارد یک سند کنید:
از روش Remove برای حذف یک بخش استفاده کنید. در صورتی که نیازی به حذف بخش خاصی از break ندارید و در عوض محتوای آن بخش را حذف می کنید می توانید از روش ClearContent استفاده کنید.
مثال کد زیر نشان می دهد که چگونه شکستن بخش ها را حذف کنیم:
یک بخش را جابجا کنید
اگر می خواهید بخشی را از یک موقعیت به موقعیت دیگر در سند خود منتقل کنید، باید فهرست آن بخش را دریافت کنید. Aspose.Words به شما اجازه می دهد تا یک موقعیت بخش از SectionCollection را بدست آورید. شما می توانید از ویژگی Sections برای دریافت تمام بخش ها در سند خود استفاده کنید. اما اگر می خواهید فقط بخش اول را دریافت کنید، می توانید از ویژگی FirstSection استفاده کنید.
مثال کد زیر نشان می دهد که چگونه به بخش اول دسترسی پیدا کنید و از طریق فرزندان یک گره ترکیبی تکرار کنید:
یک طرح بندی بخش را مشخص کنید
گاهی اوقات می خواهید سند شما با ایجاد طرح های خلاقانه برای بخش های مختلف سند بهتر به نظر برسد. اگر می خواهید نوع شبکه بخش فعلی را مشخص کنید، می توانید یک حالت طرح بندی بخش را با استفاده از شمارش SectionLayoutMode انتخاب کنید:
- پیش فرض
- شبکه
- LineGrid
- SnapToChars
مثال کد زیر نشان می دهد که چگونه تعداد خطوط هر صفحه را محدود کنیم:
ویرایش یک بخش
وقتی بخش جدیدی را به سند خود اضافه می کنید، هیچ بدن یا پاراگراف دیگری وجود نخواهد داشت که بتوانید ویرایش کنید. Aspose.Words به شما اجازه می دهد تا تضمین کنید که یک بخش شامل یک بدن با حداقل یک پاراگراف با استفاده از روش EnsureMinimum است – به طور خودکار یک گره بدن (یا HeaderFooter) را به سند اضافه می کند و سپس یک پاراگراف به آن اضافه می کند.
مثال کد زیر نشان می دهد که چگونه یک گره بخش جدید را با استفاده از EnsureMinimumآماده کنیم:
اضافه کردن یا پیشوند محتوا
اگر می خواهید در ابتدای/انتهای یک بخش شکل یا متن یا تصویر اضافه کنید، می توانید از روش های AppendContent و PrependContent کلاس Section استفاده کنید.
مثال کد زیر نشان می دهد که چگونه محتوای یک بخش موجود را اضافه کنید:
یک بخش را کلان کنید
Aspose.Words به شما اجازه می دهد تا یک بخش را با ایجاد یک کپی کامل از آن با استفاده از روش deepClone تکرار کنید.
مثال کد زیر نشان می دهد که چگونه بخش اول را در سند خود کلان کنید:
بخش های کپی بین اسناد
در برخی موارد، ممکن است اسناد بزرگی با بخش های زیادی داشته باشید و بخواهید محتوای یک بخش را از یک سند به سند دیگر کپی کنید.
Aspose.Words به شما اجازه می دهد تا بخش هایی را بین اسناد با استفاده از روش ImportNode کپی کنید.
مثال کد زیر نشان می دهد که چگونه بخش های بین اسناد را کپی کنید:
با سر و پای بخش کار کنید
قوانین اساسی برای نمایش هدر یا پاورقی برای هر بخش کاملا ساده است:
- اگر این بخش سرصفحه ها / پای صفحه های خاص خود را نداشته باشد، از بخش قبلی گرفته شده است.
- نوع header / footer نمایش داده شده در صفحه توسط تنظیمات بخش “صفحه اول متفاوت” و “صفحات عجیب و غریب و حتی متفاوت” کنترل می شود – اگر آنها غیرفعال باشند، عناوین خود بخش نادیده گرفته می شوند.
مثال کد زیر نشان می دهد که چگونه 2 بخش با سرصفحه های مختلف ایجاد کنید:
اگر می خواهید متن سرصفحه ها و پاورقی ها را بدون حذف اشیاء HeaderFooter در سند خود حذف کنید، می توانید از روش ClearHeadersFooters استفاده کنید. علاوه بر این، می توانید از روش DeleteHeaderFooterShapes برای حذف تمام اشکال از سرصفحه ها و پاورقی ها در سند خود استفاده کنید.
مثال کد زیر نشان می دهد که چگونه محتوای تمام سرصفحه ها و پای صفحه ها را در یک بخش پاک کنید:
مثال کد زیر چگونه تمام اشکال را از تمام سرصفحه ها، پای صفحه ها در یک بخش حذف کنیم:
ویژگی های صفحه را در یک بخش سفارشی کنید
قبل از چاپ یک صفحه یا یک سند ممکن است بخواهید اندازه و طرح یک صفحه یا کل سند را سفارشی و تغییر دهید. با تنظیم صفحه، می توانید تنظیمات صفحات سند مانند حاشیه ها، جهت گیری و اندازه را برای چاپ صفحات اول مختلف یا صفحات عجیب و غریب تغییر دهید.
Aspose.Words به شما اجازه می دهد تا ویژگی های صفحه و بخش را با استفاده از کلاس PageSetup سفارشی کنید.
مثال کد زیر نشان می دهد که چگونه ویژگی هایی مانند اندازه صفحه و جهت گیری برای بخش فعلی را تنظیم کنید:
مثال کد زیر نشان می دهد که چگونه ویژگی های صفحه را در تمام بخش ها تغییر دهید: