PageBreak — Aspose.Cells FOSS for Python API Reference
aspose-cells-foss tillader indsættelse af manuelle sideskift for at kontrollere, hvordan et regneark deles over udskrevne sider. Horisontale sideskift opdeler arket mellem rækker; vertikale sideskift opdeler det mellem kolonner. Begge samlinger bruger 0-based indices.
Example: 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_breaksHorizontalPageBreakCollection
Tilgås som ws.horizontal_page_breaks. Et horisontalt sideskift indsat før række n fører til, at arket starter en ny side på den række, når det udskrives.
Alle ræfereencer til rækker er 0-based (række 0 = række 1 i Excel).
Example
Kom i gang
hpb.add(row_or_cell: int | str) -> intTilføjer et sideskift før den angivne række. Returnerer den 0-baserede indeks for det nye sideskift i samlingen.
| Example | Example | Example |
|---|---|---|
row_or_cell | int | 0-based row index at which to insert the break. |
row_or_cell | str | A1-stil cellehenvisning; rækken for denne celle bruges (f.eks., "A11" → sideskift før række 10 i 0-baseret notation). |
API-reference for JsonHandler, JsonSaveOptions og modulfunktionen save_workbook_as_json i aspose-cells-foss.
hpb.remove(row_or_cell: int | str)Fjerner sideskiftet, der er knyttet til den angivne rækkeindeks eller cellehenvisning.
remove_at
hpb.remove_at(index: int)Fjerner sideskiftet på den angivne 0-baserede position i samlingen.
Workbook‑bekvem metode
hpb.clear()Fjerner alle horisontale sideskift fra regnearket.
to_list
hpb.to_list() -> listReturnerer en simpel Python-liste over de aktuelle sideskift-rækkeindekser (0-baserede heltal), sorteret i stigende rækkefølge.
Udviklerguide
| Example | Example |
|---|---|
count | Antal horisontale sideskift (skrivebeskyttet). |
__len__() | Example count. |
__iter__() | Itererer over sideskift-rækkeindekser. |
__getitem__(index) | Returnerer sideskift-rækkeindekset på position index i samlingen. |
VerticalPageBreakCollection
Tilgås som ws.vertical_page_breaks. Et vertikalt sideskift indsat før kolonne n fører til, at arket starter en ny side på den kolonne, når det udskrives.
Alle kolonnehenvisninger er 0-based (kolonne 0 = kolonne A).
Example
Kom i gang
vpb.add(column_or_cell: int | str) -> intTilføjer et sideskift før den angivne kolonne. Returnerer den 0-baserede indeks for det nye sideskift i samlingen.
| Example | Example | Example |
|---|---|---|
column_or_cell | int | 0-based column index at which to insert the break. |
column_or_cell | str | A1-stil cellehenvisning; kolonnen for denne celle bruges (f.eks., "E1" → afbryd før kolonne 4 i 0-baserede termer). |
API-reference for JsonHandler, JsonSaveOptions og modulfunktionen save_workbook_as_json i aspose-cells-foss.
vpb.remove(column_or_cell: int | str)Fjerner sideskiftet, der er knyttet til den angivne kolonneindeks eller cellehenvisning.
Workbook‑bekvem metode
vpb.clear()Fjerner alle vertikale sideskift fra regnearket.
to_list
vpb.to_list() -> listReturnerer en simpel Python liste over de aktuelle brudkolonneindekser (0-baserede heltal), sorteret i stigende rækkefølge.
Udviklerguide
| Example | Example |
|---|---|
count | Antal lodrette sideafbrydelser (kun læse). |
__len__() | Example count. |
__iter__() | Itererer over break column indices. |
__getitem__(index) | Returnerer break column index ved position index i samlingen. |
Example
Det følgende eksempel indsætter vandrette sideskift hver 30. række for at producere jævnt opdelt udskrivningssider 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")Fjernelse af et specifikt 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")