Cells
Python
PageBreak

PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss ļauj ievietot manuālus lapas pārtraukumus, lai kontrolētu, kā darblapa tiek sadalīta drukas lapās. Horizontālie lapas pārtraukumi sadala lapu starp rindām; vertikālie lapas pārtraukumi sadala to starp kolonnām. Abas kolekcijas izmanto 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

Pieejams kā ws.horizontal_page_breaks. Horizontāls lapas pārtraukums, kas ievietots pirms rindas n izraisa, ka darblapa sāk jaunu lapu šajā rindā, kad tiek drukāta.

Visas rindu atsauces ir 0-based (rinda 0 = rinda 1 programmā Excel).

ImageRenderOptions

pievienot 

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

Pievieno lapas pārtraukumu pirms norādītās rindas. Atgriež jauna pārtraukuma indeksu, kas sākas ar 0, kolekcijā.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
row_or_cellint0-based row index at which to insert the break.
row_or_cellstrA1 stila šūnas atsauce; tiek izmantota šīs šūnas rinda (piemēram,., "A11" → pārtraukums pirms rindas 10, ja skaitām no 0).

noņemt 

hpb.remove(row_or_cell: int | str)

Noņem lapas pārtraukumu, kas saistīts ar norādīto rindu indeksu vai šūnas atsauci.

remove_at 

hpb.remove_at(index: int)

Noņem lapas pārtraukumu dotajā nulles bāzētajā pozīcijā kolekcijā.

notīrīt 

hpb.clear()

Noņem visus horizontālos lapas pārtraukumus no darblapas.

to_list 

hpb.to_list() -> list

Atgriež vienkāršu Python sarakstu ar pašreizējām pārtraukuma rindu indeksēm (veseli skaitļi, kas sākas ar 0), sakārtotus augošā secībā.

Īpašības un iterācija

ImageRenderOptionsImageRenderOptions
countHorizontālo lapas pārtraukumu skaits (tikai lasāms).
__len__()ImageRenderOptions count.
__iter__()Iterē pār pārtraukuma rindu indeksiem.
__getitem__(index)Atgriež pārtraukuma rindiņas indeksu pozīcijā index kolekcijā.

VerticalPageBreakCollection

Pieejams kā ws.vertical_page_breaks. Vertikāls lapas pārtraukums, kas ievietots pirms kolonnas n izraisa, ka darblapa sāk jaunu lapu šajā kolonnā, kad tiek drukāta.

Visas kolonnu atsauces ir 0-based (kolonna 0 = kolonna A).

ImageRenderOptions

pievienot 

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

Pievieno lapas pārtraukumu pirms norādītās kolonnas. Atgriež jauna pārtraukuma nulles bāzes indeksu kolekcijā.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
column_or_cellint0-based column index at which to insert the break.
column_or_cellstrA1‑stila šūnas atsauce; tiek izmantota šīs šūnas kolonna (piemēram,., "E1" → pārtraukums pirms kolonnas 4 0‑bāzētā izteiksmē).

noņemt 

vpb.remove(column_or_cell: int | str)

Noņem lapas pārtraukumu, kas saistīts ar norādīto kolonnas indeksu vai šūnas atsauci.

notīrīt 

vpb.clear()

Noņem visus vertikālos lapas pārtraukumus no darblapas.

to_list 

vpb.to_list() -> list

Atgriež vienkāršu Python sarakstu ar pašreizējām pārtraukuma kolonnu indeksēm (0‑balstītiem veseliem skaitļiem), sakārtotu augošā secībā.

Īpašības un iterācija

ImageRenderOptionsImageRenderOptions
countVertikālo lapas pārtraukumu skaits (tikai lasāms).
__len__()ImageRenderOptions count.
__iter__()Iterē pāri pārtraukuma kolonnas indeksiem.
__getitem__(index)Atgriež pārtraukuma kolonnas indeksu pozīcijā index kolekcijā.

ImageRenderOptions

Šis piemērs ievieto horizontālus lapas pārtraukumus ik pēc 30 rindām, lai izveidotu vienmērīgi sadalītas drukas lapas lielā pārskatā.

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

Konkrēta pārtraukuma noņemšana 

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

Skatīt arī

 Latviešu