PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss امکان درج شکست‌های صفحه دستی را برای کنترل نحوه تقسیم یک برگه کاری در صفحات چاپ شده فراهم می‌کند. شکست‌های صفحه افقی برگه را بین ردیف‌ها تقسیم می‌کنند؛ شکست‌های صفحه عمودی آن را بین ستون‌ها تقسیم می‌کنند. هر دو مجموعه از 0-based indices.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import Workbook

wb = Workbook("report.xlsx")
ws = wb.worksheets[0]

hpb = ws.horizontal_page_breaks
vpb = ws.vertical_page_breaks

HorizontalPageBreakCollection

دسترسی به عنوان ws.horizontal_page_breaks. یک شکست صفحه افقی قبل از ردیف وارد شده n باعث می‌شود که برگه هنگام چاپ، صفحه جدیدی را در آن ردیف آغاز کند.

تمام ارجاعات ردیف هستند 0-based (سطر 0 = سطر 1 در اکسل).

ImageRenderOptions

افزودن

hpb.add(row_or_cell: int | str) -> int

یک شکست صفحه را قبل از ردیف مشخص شده اضافه می‌کند. ایندکس صفر‑پایهٔ شکست جدید را در مجموعه برمی‌گرداند.

حذف

hpb.remove(row_or_cell: int | str)

شکست صفحه مرتبط با ایندکس ردیف یا مرجع سلول داده شده را حذف می‌کند.

remove_at

hpb.remove_at(index: int)

شکست صفحه را در موقعیت صفر‑پایهٔ داده شده در مجموعه حذف می‌کند.

پاک‌سازی

hpb.clear()

تمام شکست‌های صفحه افقی را از برگه کاری حذف می‌کند.

to_list

hpb.to_list() -> list

یک لیست سادهٔ Python از ایندکس‌های ردیف‌های شکست فعلی (اعداد صحیح صفر‑پایه) را برمی‌گرداند که به ترتیب صعودی مرتب شده‌اند.

ویژگی‌ها و تکرار

VerticalPageBreakCollection

دسترسی به صورت ws.vertical_page_breaks. یک شکست صفحه عمودی قبل از ستون n باعث می‌شود که برگه هنگام چاپ، صفحه جدیدی را در آن ستون آغاز کند.

تمام ارجاعات ستون 0-based (ستون ۰ = ستون A).

ImageRenderOptions

افزودن

vpb.add(column_or_cell: int | str) -> int

یک شکست صفحه را قبل از ستون مشخص‌شده اضافه می‌کند. شاخص صفر‑مبناِ شکست جدید را در مجموعه برمی‌گرداند.

حذف

vpb.remove(column_or_cell: int | str)

شکست صفحه مرتبط با شاخص ستون یا ارجاع سلول داده‌شده را حذف می‌کند.

پاک‌سازی

vpb.clear()

تمام شکست‌های صفحه عمودی را از کاربرگ حذف می‌کند.

to_list

vpb.to_list() -> list

یک لیست سادهٔ Python از شاخص‌های ستون‌های شکست فعلی (اعداد صحیح صفر‑مبنا) را برمی‌گرداند، به‌صورت صعودی مرتب شده.

ویژگی‌ها و تکرار

ImageRenderOptions

مثال زیر هر 30 ردیف یک شکست صفحه افقی وارد می‌کند تا صفحات چاپی به‌صورت مساوی در یک گزارش بزرگ تقسیم شوند.

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]
ws.name = "AnnualReport"

# Write 120 rows of placeholder data
for row in range(120):
    ws.cells[row][0].put_value(f"Row {row + 1}")
    ws.cells[row][1].put_value(row * 100)

# Insert a page break before rows 30, 60, and 90 (0-based)
ws.horizontal_page_breaks.add(30)
ws.horizontal_page_breaks.add(60)
ws.horizontal_page_breaks.add(90)

print(f"Page breaks at rows: {ws.horizontal_page_breaks.to_list()}")
# Output: Page breaks at rows: [30, 60, 90]

# Add a vertical break to split wide reports after column D (index 4)
ws.vertical_page_breaks.add(4)

wb.save("annual_report_paged.xlsx")

حذف یک شکست خاص

from aspose.cells_foss import Workbook

wb = Workbook("annual_report_paged.xlsx")
ws = wb.worksheets[0]

# Remove the break at row 60 (0-based)
ws.horizontal_page_breaks.remove(60)

print(f"Remaining breaks: {ws.horizontal_page_breaks.to_list()}")
# Output: Remaining breaks: [30, 90]

wb.save("annual_report_paged.xlsx")

همچنین ببینید

• Cells Python API Reference خانه
• مرجع کلاس Workbook
• مرجع کلاس Worksheet
• شروع به کار
• راهنمای توسعه‌دهنده