Cells
Python
PageBreak

PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss maakt het mogelijk handmatige pagina-einden in te voegen om te bepalen hoe een werkblad over afgedrukte pagina’s wordt verdeeld. Horizontale pagina-einden splitsen het blad tussen rijen; verticale pagina-einden splitsen het tussen kolommen. Beide collecties gebruiken 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

Toegankelijk als ws.horizontal_page_breaks. Een horizontaal pagina-einde ingevoegd vóór rij n zorgt ervoor dat het blad bij het afdrukken een nieuwe pagina start op die rij.

Alle rijreferenties zijn 0-based (rij 0 = rij 1 in Excel).

ImageRenderOptions

add 

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

Voegt een pagina-einde toe vóór de opgegeven rij. Retourneert de nulgebaseerde index van het nieuwe einde in de collectie.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
row_or_cellint0-based row index at which to insert the break.
row_or_cellstrA1-stijl celreferentie; de rij van deze cel wordt gebruikt (bijv., "A11" → einde vóór rij 10 in 0-gebaseerde termen).

remove 

hpb.remove(row_or_cell: int | str)

Verwijdert het pagina-einde dat gekoppeld is aan de opgegeven rij-index of celreferentie.

remove_at 

hpb.remove_at(index: int)

Verwijdert het pagina-einde op de opgegeven nulgebaseerde positie in de collectie.

clear 

hpb.clear()

Verwijdert alle horizontale pagina-einden uit het werkblad.

to_list 

hpb.to_list() -> list

Retourneert een eenvoudige Python-lijst van de huidige rij-indexen van de pagina-einden (0-gebaseerde gehele getallen), gesorteerd in oplopende volgorde.

Eigenschappen en iteratie

ImageRenderOptionsImageRenderOptions
countAantal horizontale pagina-einden (alleen-lezen).
__len__()ImageRenderOptions count.
__iter__()Itereert over de indices van de einde-rijen.
__getitem__(index)Retourneert de einde-rij index op positie index in de collectie.

VerticalPageBreakCollection

Toegankelijk als ws.vertical_page_breaks. Een verticaal pagina-einde ingevoegd vóór kolom n zorgt ervoor dat het blad bij het afdrukken een nieuwe pagina start op die kolom.

Alle kolomreferenties zijn 0-based (kolom 0 = kolom A).

ImageRenderOptions

add 

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

Voegt een pagina‑einde toe vóór de opgegeven kolom. Retourneert de nulgebaseerde index van het nieuwe einde in de collectie.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
column_or_cellint0-based column index at which to insert the break.
column_or_cellstrA1-stijl celverwijzing; de kolom van deze cel wordt gebruikt (bijv., "E1" → onderbreking vóór kolom 4 in 0-gebaseerde termen).

remove 

vpb.remove(column_or_cell: int | str)

Verwijdert het pagina‑einde dat gekoppeld is aan de opgegeven kolomindex of celreferentie.

clear 

vpb.clear()

Verwijdert alle verticale pagina‑einden van het werkblad.

to_list 

vpb.to_list() -> list

Retourneert een eenvoudige Python lijst van de huidige kolomindexen van de einden (0-gebaseerde gehele getallen), gesorteerd in oplopende volgorde.

Eigenschappen en iteratie

ImageRenderOptionsImageRenderOptions
countAantal verticale pagina-onderbrekingen (alleen-lezen).
__len__()ImageRenderOptions count.
__iter__()Itereren over break column-indexen.
__getitem__(index)Retourneert de break column-index op positie index in de collectie.

ImageRenderOptions

Het volgende voorbeeld voegt elke 30 rijen een horizontaal pagina‑einde in om gelijkmatig verdeelde afdrukpagina’s te produceren in een groot rapport.

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

Een specifiek einde verwijderen 

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

Zie ook

 Nederlands