Aspose.Cells FOSS - Das ist ein Scherz.
Python
PageBreak

PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss ermöglicht das Einfügen manueller Seitenumbrüche, um zu steuern, wie ein Arbeitsblatt über gedruckte Seiten verteilt wird. Horizontale Seitenumbrüche teilen das Blatt zwischen Zeilen; vertikale Seitenumbrüche teilen es zwischen Spalten. Beide Sammlungen verwenden 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

Zugriff über ws.horizontal_page_breaks. Ein horizontaler Seitenumbruch, der vor Zeile n veranlasst das Blatt, beim Drucken an dieser Zeile eine neue Seite zu beginnen.

Alle Zeilenreferenzen sind 0-based (Zeile 0 = Zeile 1 in Excel).

Example

Kurzform für add(ChartType.PIE, ...). 

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

Fügt einen Seitenumbruch vor der angegebenen Zeile ein. Gibt den nullbasierten Index des neuen Umbruchs in der Sammlung zurück.

ExampleExampleExample
row_or_cellint0-based row index at which to insert the break.
row_or_cellstrA1-ähnliche Zellreferenz; die Zeile dieser Zelle wird verwendet (z. B., "A11" → Umbruch vor Zeile 10 in 0‑basierter Notation).

decrypt_xlsx 

hpb.remove(row_or_cell: int | str)

Entfernt den Seitenumbruch, der dem angegebenen Zeilenindex oder Zellverweis zugeordnet ist.

remove_at 

hpb.remove_at(index: int)

Entfernt den Seitenumbruch an der angegebenen nullbasierten Position in der Sammlung.

Exportiert das erste Arbeitsblatt in eine JSON‑Datei unter file_path. Wenn options None ist, werden die Standard‑JsonSaveOptions verwendet. 

hpb.clear()

Entfernt alle horizontalen Seitenumbrüche aus dem Arbeitsblatt.

to_list 

hpb.to_list() -> list

Gibt eine einfache Python-Liste der aktuellen Zeilenindex‑Umbrüche (nullbasierte Ganzzahlen) zurück, sortiert in aufsteigender Reihenfolge.

CSVHandler enthält nur statische Methoden und wird nie instanziiert.

ExampleExample
countAnzahl der horizontalen Seitenumbrüche (schreibgeschützt).
__len__()Example count.
__iter__()Iteriert über die Indizes der Umbruchzeilen.
__getitem__(index)Gibt den Umbruchzeilenindex an der Position zurück index in der Sammlung.

VerticalPageBreakCollection

Zugriff über ws.vertical_page_breaks. Ein vertikaler Seitenumbruch, der vor Spalte eingefügt wird n veranlasst das Blatt, beim Drucken an dieser Spalte eine neue Seite zu beginnen.

Alle Spaltenreferenzen sind 0-based (Spalte 0 = Spalte A).

Example

Kurzform für add(ChartType.PIE, ...). 

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

Fügt einen Seitenumbruch vor der angegebenen Spalte ein. Gibt den nullbasierten Index des neuen Umbruchs in der Sammlung zurück.

ExampleExampleExample
column_or_cellint0-based column index at which to insert the break.
column_or_cellstrA1-ähnliche Zellreferenz; die Spalte dieser Zelle wird verwendet (z. B., "E1" → Umbruch vor Spalte 4 in 0‑basierten Begriffen).

decrypt_xlsx 

vpb.remove(column_or_cell: int | str)

Entfernt den Seitenumbruch, der dem angegebenen Spaltenindex oder Zellverweis zugeordnet ist.

Exportiert das erste Arbeitsblatt in eine JSON‑Datei unter file_path. Wenn options None ist, werden die Standard‑JsonSaveOptions verwendet. 

vpb.clear()

Entfernt alle vertikalen Seitenumbrüche aus dem Arbeitsblatt.

to_list 

vpb.to_list() -> list

Gibt eine einfache Python-Liste der aktuellen Trennspaltenindizes (0-basierte Ganzzahlen) zurück, sortiert in aufsteigender Reihenfolge.

CSVHandler enthält nur statische Methoden und wird nie instanziiert.

ExampleExample
countAnzahl der vertikalen Seitenumbrüche (schreibgeschützt).
__len__()Example count.
__iter__()Iteriert über die Indizes der Umbruchspalten.
__getitem__(index)Gibt den Umbruchspaltenindex an Position zurück index in der Sammlung.

Example

Das folgende Beispiel fügt alle 30 Zeilen horizontale Seitenumbrüche ein, um auf einem großen Bericht gleichmäßig geteilte Druckseiten zu erzeugen.

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

Entfernen eines bestimmten Umbruchs 

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

Siehe auch

 Deutsch