کار با بخش ها
گاهی اوقات شما می خواهید یک سند که همان قالب بندی را در تمام صفحات نداشته باشد. به عنوان مثال، شما ممکن است نیاز به تغییر فرمت های شماره صفحه داشته باشید، اندازه و جهت گیری صفحات مختلف داشته باشید یا اولین صفحه سند را به عنوان یک صفحه پوشش بدون هیچ شماره گذاری داشته باشید. شما می توانید با بخش ها به آن دست یابید.
بخش ها گره های سطح هستند که هدرها و پاداران، جهت گیری، ستون ها، حاشیه ها، قالب بندی شماره صفحه و دیگران را کنترل می کنند.
Aspose.Words به شما اجازه می دهد بخش ها را مدیریت کنید، یک سند را به بخش ها تقسیم کنید و تغییرات قالب بندی را ایجاد کنید که فقط به یک بخش خاص اعمال می شود. Aspose.Words ذخیره اطلاعات در مورد قالب بندی بخش مانند headers و Footers، تنظیمات صفحه و تنظیمات ستون در بخش شکستن.
این مقاله توضیح می دهد که چگونه با بخش ها و بخش ها کار کنیم.
چه بخش و چه بخش است
بخش های مستند توسط Section و SectionCollection کلاس ها اشیاء بخش فرزندان فوری هستند Document گره و می تواند از طریق دسترسی Sections مالکیت شما می توانید این گره ها را با استفاده از برخی از روش ها مانند Remove, Add, IndexOf, و دیگران.
شکستن بخش یک گزینه است که صفحات سند را به بخش هایی با طرح های قابل تنظیم تقسیم می کند.
انواع یک بخش شکستن
Aspose.Words اجازه می دهد تا اسناد را با استفاده از بخش های مختلف تقسیم و فرمت کنید. BreakType تکرار:
- بخش CryContinious
- بخش Cry NewColumn
- بخش Cry NewPage
- بخش CryoPage
- بخش CryOddPage
شما همچنین می توانید از SectionStart تکرار برای انتخاب یک نوع شکستن که تنها برای بخش اول مانند NewColumn، NewPage، حتی Page و OddPage اعمال می شود.
مدیریت یک بخش
از آنجا که یک بخش یک گره کامپوزیت معمولی است، کل دستکاری گره API می تواند برای دستکاری بخش ها استفاده شود: اضافه کردن، حذف و سایر عملیات ها در بخش ها. شما می توانید در مورد گره ها در مقاله بیشتر بخوانید Aspose.Words Document Object Model (DOM)…
از سوی دیگر، می توانید از آن استفاده کنید. DocumentBuilder API برای کار با بخش ها در این مقاله، ما بر روی این روش خاص کار با بخش ها تمرکز خواهیم کرد.
اضافه کردن یا حذف یک بخش
Aspose.Words به شما اجازه می دهد تا یک بخش را با استفاده از متن وارد کنید. InsertBreak روش
مثال کد زیر نشان می دهد که چگونه یک بخش را به یک سند وارد کنید:
استفاده از Remove روش حذف یک بخش شکستن اگر نیازی به حذف یک بخش خاص ندارید و در عوض محتوای آن بخش را حذف کنید، می توانید از آن استفاده کنید. ClearContent روش
مثال کد زیر نشان می دهد که چگونه بخش ها را حذف کنیم:
حرکت یک بخش
اگر می خواهید یک بخش را از یک موقعیت به دیگری در سند خود منتقل کنید، باید شاخص آن بخش را دریافت کنید. Aspose.Words اجازه می دهد تا شما یک موقعیت بخش از یک SectionCollection… می توانید از آن استفاده کنید Sections مالکیت برای دریافت تمام بخش ها در سند شما اما اگر می خواهید فقط بخش اول را دریافت کنید، می توانید از آن استفاده کنید. FirstSection مالکیت
مثال کد زیر نشان می دهد که چگونه به بخش اول دسترسی پیدا کنید و از طریق فرزندان یک گره کامپوزیتی آن را تنظیم کنید:
یک بخش را مشخص کنید
گاهی اوقات می خواهید سند شما با ایجاد طرح های خلاقانه برای بخش های مختلف سند بهتر به نظر برسد. اگر می خواهید نوع شبکه فعلی را مشخص کنید، می توانید یک حالت طرح بخش را با استفاده از حالت چیدمان بخش انتخاب کنید. SectionLayoutMode تکرار:
- شکست
- Grid
- خط Grid
- SnapToChars
مثال کد زیر نشان می دهد که چگونه تعداد خطوطی که هر صفحه ممکن است داشته باشد را محدود کنیم:
ویرایش یک بخش
هنگامی که یک بخش جدید را به سند خود اضافه می کنید، هیچ بدن یا پاراگرافی وجود ندارد که بتوانید ویرایش کنید. Aspose.Words به شما اجازه می دهد تا تضمین کنید که یک بخش حاوی یک بدن با حداقل یک پاراگراف است. EnsureMinimum روش – به طور خودکار یک گره بدن (یا سرسرپوتر) را به سند اضافه می کند و سپس یک پاراگراف به آن اضافه می کند.
مثال کد زیر نشان می دهد که چگونه یک گره جدید را با استفاده از یک گره جدید آماده کنیم. EnsureMinimum:
Append یا Prepend Content
اگر می خواهید برخی از شکل یا اضافه کردن متن یا تصویر در ابتدای / انتهای یک بخش، شما می توانید از آن استفاده کنید. AppendContent و PrependContent روش های Section کلاس
مثال کد زیر نشان می دهد که چگونه محتوای یک بخش موجود را ارائه دهید:
Clone a Section
Aspose.Words اجازه دهید یک بخش را با ایجاد یک کپی کامل از آن با استفاده از آن تکرار کنید. deepClone روش
مثال کد زیر نشان می دهد که چگونه بخش اول را در سند خود کلون کنید:
بخش های کپی بین اسناد
در برخی موارد، شما ممکن است اسناد بزرگی با بخش های زیادی داشته باشید و می خواهید محتوای یک بخش را از یک سند به دیگری کپی کنید.
Aspose.Words اجازه می دهد تا شما را به کپی بخش بین اسناد با استفاده از ImportNode روش
مثال کد زیر نشان می دهد که چگونه بخش های بین اسناد را کپی کنیم:
کار با بخش سرسر و پا
قوانین اساسی برای نمایش یک سر یا پا برای هر بخش بسیار ساده است:
- اگر این بخش هدرها و پاهای خود را از نوع خاصی نداشته باشد، از بخش قبلی گرفته می شود.
- نوع هدر / فوتر که در صفحه نمایش داده می شود توسط “صفحه اول متنوع” و تنظیمات بخش “سخت و حتی صفحات” کنترل می شود - اگر آنها غیرفعال هستند، پس عناوین خود بخش نادیده گرفته می شوند.
مثال کد زیر نشان می دهد که چگونه دو بخش را با هدرهای مختلف ایجاد کنیم:
اگر می خواهید متن هدرها و عابران را بدون حذف کنید HeaderFooter اشیاء در سند شما، می توانید از آن استفاده کنید ClearHeadersFooters روش علاوه بر این می توانید از آن استفاده کنید. DeleteHeaderFooterShapes روش حذف همه اشکال از هدر و پا در سند خود را.
مثال کد زیر نشان می دهد که چگونه محتوای تمام هدرها و پاها را در یک بخش مشخص کنیم:
مثال زیر این است که چگونه تمام اشکال را از تمام سربرگ های پا در یک بخش حذف کنیم:
سفارشی سازی Page Properties در یک بخش
قبل از چاپ یک صفحه یا یک سند ممکن است بخواهید اندازه و طرح یک صفحه یا کل سند را سفارشی و اصلاح کنید. با تنظیم صفحه، می توانید تنظیمات صفحات سند مانند حاشیه، جهت گیری و اندازه برای چاپ صفحات اول یا صفحات عجیب مختلف را تغییر دهید.
Aspose.Words به شما اجازه می دهد تا ویژگی های صفحه و بخش را با استفاده از PageSetup کلاس
مثال کد زیر نشان می دهد که چگونه چنین ویژگی هایی را به عنوان اندازه صفحه و جهت گیری برای بخش فعلی تنظیم کنیم:
مثال کد زیر نشان می دهد که چگونه خواص صفحه را در تمام بخش ها تغییر دهید: