Cells
Python
PageBreak

PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss leidžia įterpti rankinius puslapių lūžius, kad kontroliuotumėte, kaip darbalapis padalijamas spausdinamų puslapių. Horizontalūs puslapių lūžiai skiria lapą tarp eilučių; vertikalūs lūžiai skiria jį tarp stulpelių. Abi kolekcijos naudoja 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

Prieinama kaip ws.horizontal_page_breaks. Horizontalus puslapių lūžis, įterptas prieš eilutę n sukelia, kad lapas spausdinant pradėtų naują puslapį toje eilutėje.

Visos eilučių nuorodos yra 0-based (eilutė 0 = eilutė 1 Excel programoje).

ImageRenderOptions

add 

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

Prideda puslapių lūžį prieš nurodytą eilutę. Grąžina nulinio pagrindo indeksą naujam lūžiui kolekcijoje.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
row_or_cellint0-based row index at which to insert the break.
row_or_cellstrA1 stiliaus langelio nuoroda; naudojama šio langelio eilutė (pvz., "A11" → lūžis prieš eilutę 10 0‑indeksuotoje sistemoje).

remove 

hpb.remove(row_or_cell: int | str)

Pašalina puslapių lūžį, susijusį su pateiktu eilutės indeksu arba ląstelės nuoroda.

remove_at 

hpb.remove_at(index: int)

Pašalina puslapių lūžį nurodytoje nulinio pagrindo pozicijoje kolekcijoje.

clear 

hpb.clear()

Pašalina visus horizontalus puslapių lūžius iš darbalapio.

to_list 

hpb.to_list() -> list

Grąžina paprastą Python sąrašą dabartinių lūžio eilučių indeksų (0 pagrindo sveikųjų skaičių), surūšiuotų didėjimo tvarka.

Savybės ir iteravimas

ImageRenderOptionsImageRenderOptions
countHorizontalių puslapių lūžių skaičius (tik skaitymui).
__len__()ImageRenderOptions count.
__iter__()Iteruoja per lūžio eilučių indeksus.
__getitem__(index)Grąžina lūžio eilutės indeksą pozicijoje index kolekcijoje.

VerticalPageBreakCollection

Pasiekiama kaip ws.vertical_page_breaks. Vertikalus puslapio pertraukimas įterptas prieš stulpelį n sukelia, kad lakštas spausdinant prasidėtų nauju puslapiu tame stulpelyje.

Visos stulpelių nuorodos yra 0-based (stulpelis 0 = stulpelis A).

ImageRenderOptions

add 

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

Prideda puslapių lūžį prieš nurodytą stulpelį. Grąžina nulinio pagrindo indeksą naujam lūžiui kolekcijoje.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
column_or_cellint0-based column index at which to insert the break.
column_or_cellstrA1 stiliaus langelio nuoroda; naudojamas šio langelio stulpelis (pvz., "E1" → pertrauka prieš stulpelį 4 0‑indeksuotu požiūriu).

remove 

vpb.remove(column_or_cell: int | str)

Pašalina puslapių lūžį, susijusį su pateiktu stulpelio indeksu arba ląstelės nuoroda.

clear 

vpb.clear()

Pašalina visus vertikalias puslapių lūžius iš darbalapio.

to_list 

vpb.to_list() -> list

Grąžina paprastą Python sąrašą su dabartinių pertraukų stulpelių indeksais (nulio pagrindo sveikaisiais skaičiais), surūšiuotus didėjimo tvarka.

Savybės ir iteravimas

ImageRenderOptionsImageRenderOptions
countVertikalių puslapio lūžių skaičius (tik skaitymui).
__len__()ImageRenderOptions count.
__iter__()Iteruoja per lūžio stulpelių indeksus.
__getitem__(index)Grąžina lūžio stulpelio indeksą pozicijoje. index kolekcijoje.

ImageRenderOptions

Žemiau pateiktas pavyzdys įterpia horizontalias puslapių pertraukas kas 30 eilučių, kad didelėje ataskaitoje būtų tolygiai padalintos spausdinimo puslapiai.

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

Specifinės pertraukos šalinimas 

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

Žr. taip pat

 Lietuvių