Cells
PageBreak

PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss дозволяє вставляти ручні розриви сторінок, щоб контролювати, як аркуш розділяється на надрукованих сторінках. Горизонтальні розриви сторінок розділяють лист між рядками; вертикальні розриви сторінок розділяють його між стовпцями. Обидві колекції використовують 0-based indices.

Enumerations: 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 в Excel).

Enumerations

add 

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

Додає розрив сторінки перед вказаним рядком. Повертає нульовий індекс нового розриву в колекції.

EnumerationsEnumerationsEnumerations
row_or_cellint0-based row index at which to insert the break.
row_or_cellstrПосилання на клітинку у стилі A1; використовується рядок цієї клітинки (наприклад,., "A11" → розрив перед рядком 10 у 0‑базовому форматі).

remove 

hpb.remove(row_or_cell: int | str)

Видаляє розрив сторінки, пов’язаний з заданим індексом рядка або посиланням на клітинку.

remove_at 

hpb.remove_at(index: int)

Видаляє розрив сторінки у вказаній нульовій позиції в колекції.

clear 

hpb.clear()

Видаляє всі горизонтальні розриви сторінок з аркуша.

to_list 

hpb.to_list() -> list

Повертає простий список Python поточних індексів рядків розриву (цілі числа, починаючи з 0), відсортованих за зростанням.

Властивості та ітерація

EnumerationsEnumerations
countКількість горизонтальних розривів сторінки (тільки для читання).
__len__()Enumerations count.
__iter__()Ітерує індекси рядків розриву.
__getitem__(index)Повертає індекс рядка розриву у позиції index у колекції.

VerticalPageBreakCollection

Доступно як ws.vertical_page_breaks. Вертикальний розрив сторінки, вставлений перед стовпцем n змушує лист починати нову сторінку на цьому стовпці під час друку.

Усі посилання на стовпці є 0-based (стовпець 0 = стовпець A).

Enumerations

add 

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

Додає розрив сторінки перед вказаним стовпцем. Повертає нульовий індекс нового розриву в колекції.

EnumerationsEnumerationsEnumerations
column_or_cellint0-based column index at which to insert the break.
column_or_cellstrПосилання на клітинку у стилі A1; використовується стовпець цієї клітинки (наприклад,., "E1" → розрив перед стовпцем 4 у 0‑базових термінах).

remove 

vpb.remove(column_or_cell: int | str)

Видаляє розрив сторінки, пов’язаний з заданим індексом стовпця або посиланням на клітинку.

clear 

vpb.clear()

Видаляє всі вертикальні розриви сторінок з аркуша.

to_list 

vpb.to_list() -> list

Повертає простий Python список поточних індексів стовпців розриву (цілі числа, починаючи з 0), відсортованих за зростанням.

Властивості та ітерація

EnumerationsEnumerations
countКількість вертикальних розривів сторінок (тільки для читання).
__len__()Enumerations count.
__iter__()Перебирає індекси стовпців розриву.
__getitem__(index)Повертає індекс стовпця розриву у позиції index у колекції.

Enumerations

У наведеному прикладі вставляються горизонтальні розриви сторінок кожні 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")

Див. також

 Українська