Cells
Python
PageBreak

PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss tillater å sette inn manuelle sideskift for å kontrollere hvordan et regneark deles opp over utskrevne sider. Horisontale sideskift deler arket mellom rader; vertikale sideskift deler det mellom kolonner. Begge samlinger bruker 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

Tilgjengelig som ws.horizontal_page_breaks. Et horisontalt sideskift satt inn før rad n fører til at arket starter en ny side på den raden ved utskrift.

Alle radreferanser er 0-based (rad 0 = rad 1 i Excel).

ImageRenderOptions

add 

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

Legger til et sideskift før den angitte raden. Returnerer den nullbaserte indeksen til det nye sideskiftet i samlingen.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
row_or_cellint0-based row index at which to insert the break.
row_or_cellstrA1-stil celle-referanse; raden til denne cellen brukes (f.eks., "A11" → sideskift før rad 10 i 0-baserte termer).

remove 

hpb.remove(row_or_cell: int | str)

Fjerner sideskiftet som er knyttet til den gitte radindeksen eller celle-referansen.

remove_at 

hpb.remove_at(index: int)

Fjerner sideskiftet på den gitte nullbaserte posisjonen i samlingen.

clear 

hpb.clear()

Fjerner alle horisontale sideskift fra regnearket.

to_list 

hpb.to_list() -> list

Returnerer en enkel Python-liste over de nåværende sideskift-radindeksene (0-baserte heltall), sortert i stigende rekkefølge.

Egenskaper og iterasjon

ImageRenderOptionsImageRenderOptions
countAntall horisontale sideskift (skrivebeskyttet).
__len__()ImageRenderOptions count.
__iter__()Itererer over sideskift radindekser.
__getitem__(index)Returnerer sideskift radindeks på posisjon index i samlingen.

VerticalPageBreakCollection

Tilgjengelig som ws.vertical_page_breaks. Et vertikalt sideskift satt inn før kolonne n fører til at arket starter en ny side på den kolonnen ved utskrift.

Alle kolonnereferanser er 0-based (kolonne 0 = kolonne A).

ImageRenderOptions

add 

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

Legger til et sideskift før den angitte kolonnen. Returnerer den nullbaserte indeksen til det nye sideskiftet i samlingen.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
column_or_cellint0-based column index at which to insert the break.
column_or_cellstrA1-stil celle-referanse; kolonnen til denne cellen brukes (f.eks., "E1" → brudd før kolonne 4 i 0-basert terminologi).

remove 

vpb.remove(column_or_cell: int | str)

Fjerner sideskiftet som er knyttet til den gitte kolonneindeksen eller celle-referansen.

clear 

vpb.clear()

Fjerner alle vertikale sideskift fra regnearket.

to_list 

vpb.to_list() -> list

Returnerer en enkel Python-liste over de nåværende sideskift-kolonneindeksene (0-baserte heltall), sortert i stigende rekkefølge.

Egenskaper og iterasjon

ImageRenderOptionsImageRenderOptions
countAntall vertikale sideskift (kun lesebar).
__len__()ImageRenderOptions count.
__iter__()Itererer over break column-indekser.
__getitem__(index)Returnerer break column-indeksen på posisjon index i samlingen.

ImageRenderOptions

Følgende eksempel setter inn horisontale sideskift hver 30. rad for å lage jevnt delte utskriftssider i en stor 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")

Fjerne et spesifikt sideskift 

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

Se også

 Norsk