PageBreak — Aspose.Cells FOSS for Python API Reference

az aspose-cells-foss lehetővé teszi manuális oldaltörések beszúrását, hogy szabályozza, hogyan oszlik fel egy munkalap a nyomtatott oldalakon. A vízszintes oldaltörések a táblázatot a sorok között osztják; a függőleges oldaltörések az oszlopok között. Mindkét gyűjtemény használja 0-based indices.

ColladaSaveOptions: 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

Elérhetőként ws.horizontal_page_breaks. A vízszintes oldaltörés, amely a sor előtt van beszúrva n azt eredményezi, hogy a munkalap nyomtatáskor új oldalon kezdődik azon a soron.

Minden sorhivatkozás 0-based (0. sor = 1. sor az Excelben).

ColladaSaveOptions

Properties

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

Oldaltörést ad hozzá a megadott sor előtt. Visszaadja az új törés 0‑bázisú indexét a gyűjteményben.

eltávolítás

hpb.remove(row_or_cell: int | str)

Eltávolítja a megadott sorindexhez vagy cellahivatkozáshoz tartozó oldaltörést.

remove_at

hpb.remove_at(index: int)

Eltávolítja a gyűjteményben a megadott 0‑bázisú pozícióban lévő oldaltörést.

törlés

hpb.clear()

Eltávolítja az összes vízszintes oldaltörést a munkalapról.

to_list

hpb.to_list() -> list

Visszaad egy egyszerű Python listát a jelenlegi törés sorindexekről (0‑bázisú egész számok), növekvő sorrendben rendezve.

add_pie

VerticalPageBreakCollection

Elérhetőként ws.vertical_page_breaks. A függőleges oldaltörés, amely az oszlop előtt van beszúrva n azt eredményezi, hogy a munkalap nyomtatáskor új oldalon kezdődik azon az oszlopon.

Minden oszlophivatkozás 0-based (oszlop 0 = oszlop A).

ColladaSaveOptions

Properties

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

Az adott oszlop előtt oldaltörést ad hozzá. Visszaadja az új törés nulla alapú indexét a gyűjteményben.

eltávolítás

vpb.remove(column_or_cell: int | str)

Eltávolítja a megadott oszlindexhez vagy cellahivatkozáshoz tartozó oldaltörést.

törlés

vpb.clear()

Eltávolítja az összes függőleges oldaltörést a munkalapról.

to_list

vpb.to_list() -> list

Visszaad egy egyszerű Python listát a jelenlegi törésoszlop-indexekről (nulla alapú egész számok), növekvő sorrendben rendezve.

add_pie

ColladaSaveOptions

Az alábbi példa minden 30. sor után vízszintes oldaltörést szúr be, hogy egy nagy jelentés nyomtatási oldalait egyenletesen ossza fel.

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

Egy adott törés eltávolítása

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

Lásd még

• Properties
• Example
• Az alábbi példa havi bevételi adatokat ír, egy csoportosított oszlopdiagramot hoz létre címmel és két adat sorozattal, majd elmenti a munkafüzetet.
• Első lépések
• Cells Python API Referencia kezdőlap