Aspose.Cells FOSS - Aspose.CellsKopy
Python
PageBreak

PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss umožňuje vkládat ruční zalomení stránek pro kontrolu toho, jak je list rozdělen na tištěných stránkách. Horizontální zalomení stránek rozdělují list mezi řádky; vertikální zalomení stránek rozdělují mezi sloupci. Obě kolekce používají 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_breaks

HorizontalPageBreakCollection

Přístup jako ws.horizontal_page_breaks. Horizontální zalomení stránky vložené před řádek n způsobí, že list začne novou stránku na tomto řádku při tisku.

Všechny odkazy na řádky jsou 0-based (řádek 0 = řádek 1 v Excelu).

Example

Zkratka pro add(ChartType.PIE, ...). 

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

Přidá zalomení stránky před zadaný řádek. Vrací index nového zalomení v kolekci, počítaný od nuly.

ExampleExampleExample
row_or_cellint0-based row index at which to insert the break.
row_or_cellstrOdkaz na buňku ve stylu A1; řádek této buňky se používá (např., "A11" → zalomení před řádkem 10 v 0‑základním označení).

remove 

hpb.remove(row_or_cell: int | str)

Odstraní zalomení stránky spojené s daným indexem řádku nebo odkazem na buňku.

remove_at 

hpb.remove_at(index: int)

Odstraní zalomení stránky na zadané pozici v kolekci (indexováno od nuly).

CipherAlgorithm je IntEnum určující délku klíče AES. Všechny varianty používají AES v režimu CBC s blokovou velikostí 16 bajtů. 

hpb.clear()

Odstraní všechna horizontální zalomení stránek z listu.

to_list 

hpb.to_list() -> list

Vrací prostý Python seznam aktuálních indexů řádků zalomení (celá čísla od 0), seřazený vzestupně.

ChartSeries představuje jednu datovou řadu v grafu. Získá se přes chart.n_series[index].

ExampleExample
countPočet horizontálních zalomení stránek (pouze pro čtení).
__len__()Example count.
__iter__()Iteruje přes indexy řádků zalomení.
__getitem__(index)Vrací index řádku zalomení na pozici index v kolekci.

VerticalPageBreakCollection

Přístup jako ws.vertical_page_breaks. Vertikální zalomení stránky vložené před sloupec n způsobí, že list začne novou stránku na tomto sloupci při tisku.

Všechny odkazy na sloupce jsou 0-based (sloupec 0 = sloupec A).

Example

Zkratka pro add(ChartType.PIE, ...). 

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

Přidá zalomení stránky před zadaný sloupec. Vrací index nového zalomení v kolekci, počítaný od nuly.

ExampleExampleExample
column_or_cellint0-based column index at which to insert the break.
column_or_cellstrOdkaz na buňku ve stylu A1; používá se sloupec této buňky (např., "E1" → zlom před sloupcem 4 v 0‑základním zápisu).

remove 

vpb.remove(column_or_cell: int | str)

Odstraní zalomení stránky spojené s daným indexem sloupce nebo odkazem na buňku.

CipherAlgorithm je IntEnum určující délku klíče AES. Všechny varianty používají AES v režimu CBC s blokovou velikostí 16 bajtů. 

vpb.clear()

Odstraní všechna svislá zalomení stránky z listu.

to_list 

vpb.to_list() -> list

Vrací prostý Python seznam aktuálních indexů sloupců pro zalomení (celá čísla od nuly), seřazený ve vzestupném pořadí.

ChartSeries představuje jednu datovou řadu v grafu. Získá se přes chart.n_series[index].

ExampleExample
countPočet svislých zalomení stránek (pouze pro čtení).
__len__()Example count.
__iter__()Iteruje přes indexy sloupců přerušení.
__getitem__(index)Vrací index sloupce přerušení na pozici index ve sbírce.

Example

Následující příklad vkládá vodorovná zalomení stránky každých 30 řádků, aby vytvořil rovnoměrně rozdělené tiskové stránky ve velké zprávě.

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

Odstranění konkrétního zalomení 

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

Viz také

 Čeština