Aspose.Cells FOSS
Python
PageBreak

PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss umožňuje vkladať manuálne zalomenia stránok na kontrolu toho, ako je pracovný hárok rozdelený na tlačených stránkach. Horizontálne zalomenia stránok rozdeľujú hárok medzi riadkami; vertikálne zalomenia stránok rozdeľujú medzi stĺpcami. Obe kolekcie používajú 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

Prístupné ako ws.horizontal_page_breaks. Horizontálne zalomenie stránky vložené pred riadkom n spôsobí, že hárok začne novú stránku na tomto riadku pri tlači.

Všetky odkazy na riadky sú 0-based (riadok 0 = riadok 1 v Exceli).

ImageRenderOptions

add 

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

Pridá zalomenie stránky pred určený riadok. Vráti index nového zalomenia v kolekcii, počítaný od 0.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
row_or_cellint0-based row index at which to insert the break.
row_or_cellstrOdkaz na bunku v štýle A1; riadok tejto bunky sa používa (napr., "A11" → zalomenie pred riadkom 10 v 0-základnom výraze).

remove 

hpb.remove(row_or_cell: int | str)

Odstráni zalomenie stránky spojené s daným indexom riadku alebo referenciou na bunku.

remove_at 

hpb.remove_at(index: int)

Odstráni zalomenie stránky na zadanom nulovo‑základnom (0‑based) mieste v kolekcii.

clear 

hpb.clear()

Odstráni všetky horizontálne zalomenia stránok z pracovného hárku.

to_list 

hpb.to_list() -> list

Vráti obyčajný Python zoznam aktuálnych indexov riadkov zalomenia (celé čísla od 0), zoradený vzostupne.

Vlastnosti a iterácia

ImageRenderOptionsImageRenderOptions
countPočet horizontálnych zalomení stránok (iba na čítanie).
__len__()ImageRenderOptions count.
__iter__()Iteruje cez indexy riadkov zalomenia.
__getitem__(index)Vráti index riadku zalomenia na pozícii index v kolekcii.

VerticalPageBreakCollection

Prístupné ako ws.vertical_page_breaks. Vertikálne zalomenie stránky vložené pred stĺpcom n spôsobí, že hárok začne novú stránku na tomto stĺpci pri tlači.

Všetky odkazy na stĺpce sú 0-based (stĺpec 0 = stĺpec A).

ImageRenderOptions

add 

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

Pridá zalomenie stránky pred určený stĺpec. Vráti index nového zalomenia v kolekcii, počítaný od 0.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
column_or_cellint0-based column index at which to insert the break.
column_or_cellstrOdkaz na bunku v štýle A1; používa sa stĺpec tejto bunky (napr., "E1" → zlom pred stĺpcom 4 v 0‑základnom zmysle).

remove 

vpb.remove(column_or_cell: int | str)

Odstráni zalomenie stránky spojené s daným indexom stĺpca alebo referenciou na bunku.

clear 

vpb.clear()

Odstráni všetky vertikálne zalomenia stránok z pracovného hárku.

to_list 

vpb.to_list() -> list

Vráti obyčajný Python zoznam aktuálnych indexov stĺpcov pre zalomenie (celé čísla s indexom od 0), zoradený vzostupne.

Vlastnosti a iterácia

ImageRenderOptionsImageRenderOptions
countPočet vertikálnych zalomení stránok (iba na čítanie).
__len__()ImageRenderOptions count.
__iter__()Iteruje cez indexy break column.
__getitem__(index)Vráti index break column na pozícii index v kolekcii.

ImageRenderOptions

Nasledujúci príklad vkladá vodorovné zalomenia strán každých 30 riadkov, aby sa na veľkej správe vytvorili rovnomerne rozdelené tlačové strany.

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

Odstránenie konkrétneho zalomenia 

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

Pozri tiež

 Slovenčina