PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss consente di inserire interruzioni di pagina manuali per controllare come un foglio di lavoro è suddiviso nelle pagine stampate. Le interruzioni di pagina orizzontali dividono il foglio tra le righe; le interruzioni di pagina verticali lo dividono tra le colonne. Entrambe le raccolte usano 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

Accesso come ws.horizontal_page_breaks. Interruzione di pagina orizzontale inserita prima della riga n fa sì che il foglio inizi una nuova pagina in quella riga quando viene stampato.

Tutti i riferimenti di riga sono 0-based (riga 0 = riga 1 in Excel).

ImageRenderOptions

aggiungi

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

Aggiunge un’interruzione di pagina prima della riga specificata. Restituisce l’indice a base zero della nuova interruzione nella collezione.

rimuovi

hpb.remove(row_or_cell: int | str)

Rimuove l’interruzione di pagina associata all’indice di riga o al riferimento di cella fornito.

remove_at

hpb.remove_at(index: int)

Rimuove l’interruzione di pagina nella posizione a base zero specificata nella collezione.

clear

hpb.clear()

Rimuove tutte le interruzioni di pagina orizzontali dal foglio di lavoro.

to_list

hpb.to_list() -> list

Restituisce un semplice elenco Python degli indici di riga delle interruzioni correnti (interi a base zero), ordinati in ordine crescente.

Proprietà e iterazione

VerticalPageBreakCollection

Accessibile come ws.vertical_page_breaks. Un’interruzione di pagina verticale inserita prima della colonna n fa sì che il foglio inizi una nuova pagina in quella colonna quando stampato.

Tutti i riferimenti di colonna sono 0-based (colonna 0 = colonna A).

ImageRenderOptions

aggiungi

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

Aggiunge un’interruzione di pagina prima della colonna specificata. Restituisce l’indice a base zero della nuova interruzione nella collezione.

rimuovi

vpb.remove(column_or_cell: int | str)

Rimuove l’interruzione di pagina associata all’indice di colonna o al riferimento di cella fornito.

clear

vpb.clear()

Rimuove tutte le interruzioni di pagina verticali dal foglio di lavoro.

to_list

vpb.to_list() -> list

Restituisce un semplice elenco Python degli indici delle colonne di interruzione correnti (interi a base 0), ordinati in ordine crescente.

Proprietà e iterazione

ImageRenderOptions

Il seguente esempio inserisce interruzioni di pagina orizzontali ogni 30 righe per produrre pagine di stampa suddivise uniformemente in un report di grandi dimensioni.

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

Rimozione di un’interruzione specifica

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

Vedi anche

• Cells Python Riferimento API home
• Riferimento classe Workbook
• Riferimento classe Worksheet
• Guida introduttiva
• Guida per sviluppatori