Cells
Python
PageBreak

PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss mahdollistaa manuaalisten sivunvaihtojen lisäämisen hallitsemaan, miten laskentataulukko jaetaan tulostettavilla sivuilla. Vaakasuorat sivunvaihdot jakavat taulukon rivien väliin; pystysuuntaiset sivunvaihdot jakavat sen sarakkeiden väliin. Molemmat kokoelmat käyttävät 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

Käytettävissä muodossa ws.horizontal_page_breaks. Vaakasuora sivunvaihto, joka on lisätty ennen riviä n aiheuttaa sen, että taulukko aloittaa uuden sivun kyseisessä rivissä tulostettaessa.

Kaikki riviviitteet ovat 0-based (rivi 0 = rivi 1 Excelissä).

ImageRenderOptions

lisää 

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

Lisää sivunvaihdon ennen määritettyä riviä. Palauttaa uuden vaihdon nollapohjaisen indeksin kokoelmassa.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
row_or_cellint0-based row index at which to insert the break.
row_or_cellstrA1-tyylinen solun viite; tämän solun riviä käytetään (esim., "A11" → vaihto ennen riviä 10 nollapohjaisessa numeroinnissa).

poista 

hpb.remove(row_or_cell: int | str)

Poistaa annetun rivin indeksin tai solun viitteen kanssa liitetyn sivunvaihdon.

remove_at 

hpb.remove_at(index: int)

Poistaa sivunvaihdon annetusta nollapohjaisesta sijainnista kokoelmassa.

tyhjennä 

hpb.clear()

Poistaa kaikki vaakasuorat sivunvaihdot laskentataulukosta.

to_list 

hpb.to_list() -> list

Palauttaa tavallisen Python-listan nykyisistä sivunvaihdon rivin indekseistä (nollapohjaiset kokonaisluvut), järjestettynä nousevaan järjestykseen.

Ominaisuudet ja iteraatio

ImageRenderOptionsImageRenderOptions
countVaakasuorien sivunvaihtojen määrä (vain luku).
__len__()ImageRenderOptions count.
__iter__()Iteroi sivunvaihtojen rivi-indeksejä.
__getitem__(index)Palauttaa sivunvaihdon rivi-indeksin kohdassa index kokoelmassa.

VerticalPageBreakCollection

Käytettävissä muodossa ws.vertical_page_breaks. Pystysuora sivunvaihto, joka on lisätty ennen saraketta n aiheuttaa sen, että taulukko aloittaa uuden sivun kyseisessä sarakkeessa tulostettaessa.

Kaikki sarakeviitteet ovat 0-based (sarake 0 = sarake A).

ImageRenderOptions

lisää 

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

Lisää sivunvaihdon ennen määritettyä saraketta. Palauttaa nollapohjaisen indeksin uudelle vaihdolle kokoelmassa.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
column_or_cellint0-based column index at which to insert the break.
column_or_cellstrA1-tyylinen solun viite; tämän solun saraketta käytetään (esim., "E1" → tauko ennen saraketta 4 nollapohjaisessa merkityksessä).

poista 

vpb.remove(column_or_cell: int | str)

Poistaa annetun sarakeindeksin tai solun viitteen kanssa liitetyn sivunvaihdon.

tyhjennä 

vpb.clear()

Poistaa kaikki pystysuuntaiset sivunvaihdot taulukosta.

to_list 

vpb.to_list() -> list

Palauttaa tavallisen Python -listan nykyisistä sivunvaihdon sarakeindekseistä (nollapohjaiset kokonaisluvut), järjestettynä nousevaan järjestykseen.

Ominaisuudet ja iteraatio

ImageRenderOptionsImageRenderOptions
countPystysivunvaihtojen määrä (vain luku).
__len__()ImageRenderOptions count.
__iter__()Iteroi break column indices.
__getitem__(index)Palauttaa break column index kohdassa index kokoelmassa.

ImageRenderOptions

Seuraava esimerkki lisää vaakasuuntaisia sivunvaihtoja 30 rivin välein tuottaakseen tasaisesti jaetut tulostussivut suuressa raportissa.

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

Tietyn sivunvaihdon poistaminen 

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

Katso myös

 Suomi