PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss omogućava umetanje ručnih prekida stranica kako bi se kontrolisalo kako se radni list deli na odštampanim stranicama. Horizontalni prekidi stranica razdvajaju list između redova; vertikalni prekidi stranica razdvajaju ga između kolona. Obe kolekcije koriste 0-based indices.

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

Pristupa se kao ws.horizontal_page_breaks. Horizontalni prekid stranice umetnut pre reda n prouzrokuje da list započne novu stranicu na tom redu prilikom štampanja.

Sve reference na redove su 0-based (red 0 = red 1 u Excelu).

add

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

Dodaje prekid stranice pre navedenog reda. Vraća indeks novog prekida u kolekciji, koji je 0‑baziran.

remove

hpb.remove(row_or_cell: int | str)

Uklanja prekid stranice koji je povezan sa datim indeksom reda ili referencom na ćeliju.

remove_at

hpb.remove_at(index: int)

Uklanja prekid stranice na datoj 0‑baziranoj poziciji u kolekciji.

clear

hpb.clear()

Uklanja sve horizontalne prekide stranica iz radnog lista.

to_list

hpb.to_list() -> list

Vraća običnu Python listu trenutnih indeksa redova prekida (cijele brojeve 0‑bazirane), sortiranu u rastućem redosledu.

Svojstva i iteracija

VerticalPageBreakCollection

Pristupa se kao ws.vertical_page_breaks. Vertikalni prekid stranice umetnut pre kolone n prouzrokuje da list započne novu stranicu na toj koloni prilikom štampanja.

Sve reference na kolone su 0-based (kolona 0 = kolona A).

add

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

Dodaje prekid stranice pre navedene kolone. Vraća indeks novog prekida u kolekciji, koji je 0‑baziran.

remove

vpb.remove(column_or_cell: int | str)

Uklanja prekid stranice koji je povezan sa datim indeksom kolone ili referencom na ćeliju.

clear

vpb.clear()

Uklanja sve vertikalne prekide stranica iz radnog lista.

to_list

vpb.to_list() -> list

Vraća običnu Python listu trenutnih indeksa kolona prekida (cijeli brojevi počevši od 0), sortiranu u rastućem redosledu.

Svojstva i iteracija

Sledeći primer ubacuje horizontalne prekide stranice svakih 30 redova kako bi se proizvele ravnomerno podeljene štampane stranice na velikom izveštaju.

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")

Uklanjanje specifičnog prekida

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")

Vidi i

• Cells Python API Reference početna
• Reference klase Workbook
• Referenca klase Worksheet
• Početak
• Vodič za programere