PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss permet inserir salts de pàgina manuals per controlar com es divideix un full de càlcul entre les pàgines impreses. Els salts de pàgina horitzontals divideixen el full entre files; els salts de pàgina verticals el divideixen entre columnes. Ambdues col·leccions utilitzen 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

Accedit com a ws.horizontal_page_breaks. Un salt de pàgina horitzontal inserit abans de la fila n fa que el full comenci una nova pàgina en aquesta fila quan s’imprimeix.

Totes les referències de fila són 0-based (fila 0 = fila 1 a Excel).

Example

add_error_bars

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

Afegeix un salt de pàgina abans de la fila especificada. Retorna l’índex basat en zero del nou salt a la col·lecció.

Validació de llista desplegable

hpb.remove(row_or_cell: int | str)

Elimina el salt de pàgina associat amb l’índex de fila o la referència de cel·la proporcionats.

remove_at

hpb.remove_at(index: int)

Elimina el salt de pàgina a la posició basada en zero indicada a la col·lecció.

Registra un objecte DataValidation preconfigurat. Retorna el mateix objecte.

hpb.clear()

Elimina tots els salts de pàgina horitzontals del full de càlcul.

to_list

hpb.to_list() -> list

Retorna una llista Python simple dels índexs de fila dels salts actuals (enteros basats en zero), ordenada en ordre ascendent.

Cells Python Referència de l’API inici

VerticalPageBreakCollection

Accedit com a ws.vertical_page_breaks. Un salt de pàgina vertical inserit abans de la columna n fa que el full comenci una nova pàgina en aquesta columna quan s’imprimeix.

Totes les referències de columna són 0-based (columna 0 = columna A).

Example

add_error_bars

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

Afegeix un salt de pàgina abans de la columna especificada. Retorna l’índex basat en zero del nou salt a la col·lecció.

Validació de llista desplegable

vpb.remove(column_or_cell: int | str)

Elimina el salt de pàgina associat amb l’índex de columna o la referència de cel·la proporcionats.

Registra un objecte DataValidation preconfigurat. Retorna el mateix objecte.

vpb.clear()

Elimina tots els salts de pàgina verticals del full de càlcul.

to_list

vpb.to_list() -> list

Retorna una llista Python simple dels índexs de columna de tall actuals (enters basats en zero), ordenada en ordre ascendent.

Cells Python Referència de l’API inici

Example

L’exemple següent insereix salts de pàgina horitzontals cada 30 files per produir pàgines d’impressió dividides uniformement en un informe gran.

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

Eliminació d’un tall específic

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

Vegeu també

• DataValidationOperator és un IntEnum que especifica l’operador de comparació utilitzat amb restriccions numèriques/de data/de temps/de longitud.
• CSVHandler només conté mètodes estàtics i mai no s’instancia.
• CSVHandler.save_csv
• Començar
• Desa el full de treball especificat de workbook a un fitxer CSV a file_path. Si options és None, s’utilitzen les CSVSaveOptions per defecte.