FOSS (Fosul)
Python
PageBreak

PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss permite inserarea de întreruperi de pagină manuale pentru a controla modul în care o foaie de calcul este împărțită pe paginile tipărite. Întreruperile de pagină orizontale împarte foaia între rânduri; întreruperile de pagină verticale o împarte între coloane. Ambele colecții utilizează 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

Accesat ca ws.horizontal_page_breaks. O întrerupere de pagină orizontală inserată înainte de rând n face ca foaia să înceapă o pagină nouă la acel rând când este tipărită.

Toate referințele la rânduri sunt 0-based (rândul 0 = rândul 1 în Excel).

ImageRenderOptions

add 

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

Adaugă o întrerupere de pagină înainte de rândul specificat. Returnează indicele, începând de la 0, al noii întreruperi în colecție.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
row_or_cellint0-based row index at which to insert the break.
row_or_cellstrReferință de celulă în stil A1; rândul acestei celule este utilizat (de ex., "A11" → întrerupere înainte de rândul 10 în termeni cu indexare de la 0).

remove 

hpb.remove(row_or_cell: int | str)

Elimină întreruperea de pagină asociată cu indicele de rând furnizat sau cu referința la celulă.

remove_at 

hpb.remove_at(index: int)

Elimină întreruperea de pagină de la poziția specificată, cu indexare de la 0, în colecție.

clear 

hpb.clear()

Elimină toate întreruperile de pagină orizontale din foaia de calcul.

to_list 

hpb.to_list() -> list

Returnează o listă simplă Python a indicilor de rând curenți pentru întreruperi (numere întregi cu indexare de la 0), sortată în ordine ascendentă.

Proprietăți și iterare

ImageRenderOptionsImageRenderOptions
countNumărul de întreruperi de pagină orizontale (doar citire).
__len__()ImageRenderOptions count.
__iter__()Iterează peste indicii de rânduri ale întreruperilor.
__getitem__(index)Returnează indicele de rând al întreruperii la poziția index în colecție.

VerticalPageBreakCollection

Accesat ca ws.vertical_page_breaks. O întrerupere verticală de pagină inserată înainte de coloana n face ca foaia să înceapă o pagină nouă la acea coloană când este tipărită.

Toate referințele la coloane sunt 0-based (coloana 0 = coloana A).

ImageRenderOptions

add 

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

Adaugă o întrerupere de pagină înainte de coloana specificată. Returnează indicele, începând de la 0, al noii întreruperi în colecție.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
column_or_cellint0-based column index at which to insert the break.
column_or_cellstrReferință de celulă în stil A1; coloana acestei celule este utilizată (de ex., "E1" → întrerupere înainte de coloana 4 în termeni cu indexare de la 0).

remove 

vpb.remove(column_or_cell: int | str)

Elimină întreruperea de pagină asociată cu indicele de coloană furnizat sau cu referința la celulă.

clear 

vpb.clear()

Elimină toate întreruperile de pagină verticale din foaia de calcul.

to_list 

vpb.to_list() -> list

Returnază o listă simplă Python a indicilor de coloană de întrerupere curenți (numere întregi cu bază 0), sortată în ordine ascendentă.

Proprietăți și iterare

ImageRenderOptionsImageRenderOptions
countNumărul de întreruperi verticale de pagină (doar citire).
__len__()ImageRenderOptions count.
__iter__()Iterează peste indicii coloanelor de întrerupere.
__getitem__(index)Returnează indicele coloanei de întrerupere la poziția index în colecție.

ImageRenderOptions

Exemplul de mai jos inserează întreruperi de pagină orizontale la fiecare 30 de rânduri pentru a produce pagini tipărite împărțite uniform într-un raport mare.

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

Înlăturarea unei întreruperi specifice 

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

Vezi și

 Română