PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss permite insertar saltos de página manuales para controlar cómo se divide una hoja de cálculo en las páginas impresas. Los saltos de página horizontales dividen la hoja entre filas; los saltos de página verticales la dividen entre columnas. Ambas colecciones usan 0-based indices.

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

Accedido como ws.horizontal_page_breaks. Un salto de página horizontal insertado antes de la fila n hace que la hoja comience una nueva página en esa fila al imprimir.

Todas las referencias de fila son 0-based (fila 0 = fila 1 en Excel).

Examples

agregar

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

Agrega un salto de página antes de la fila especificada. Devuelve el índice basado en 0 del nuevo salto en la colección.

eliminar

hpb.remove(row_or_cell: int | str)

Elimina el salto de página asociado al índice de fila o referencia de celda proporcionados.

remove_at

hpb.remove_at(index: int)

Elimina el salto de página en la posición basada en 0 dada en la colección.

limpiar

hpb.clear()

Elimina todos los saltos de página horizontales de la hoja de cálculo.

to_list

hpb.to_list() -> list

Devuelve una lista Python simple de los índices de fila de los saltos actuales (enteros basados en 0), ordenada en forma ascendente.

Propiedades e Iteración

VerticalPageBreakCollection

Accedido como ws.vertical_page_breaks. Un salto de página vertical insertado antes de la columna n hace que la hoja comience una nueva página en esa columna al imprimirse.

Todas las referencias de columna son 0-based (columna 0 = columna A).

Examples

agregar

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

Agrega un salto de página antes de la columna especificada. Devuelve el índice basado en 0 del nuevo salto en la colección.

eliminar

vpb.remove(column_or_cell: int | str)

Elimina el salto de página asociado al índice de columna o referencia de celda proporcionados.

limpiar

vpb.clear()

Elimina todos los saltos de página verticales de la hoja de cálculo.

to_list

vpb.to_list() -> list

Devuelve una lista Python simple de los índices de columna de los saltos actuales (enteros basados en 0), ordenada en orden ascendente.

Propiedades e Iteración

Examples

El siguiente ejemplo inserta saltos de página horizontales cada 30 filas para producir páginas de impresión divididas uniformemente en un informe extenso.

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

Eliminando un Salto Específico

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

Ver también

• Celdas Python API Reference home
• Referencia de la clase Workbook
• Referencia de la clase Worksheet
• Primeros pasos
• Guía del Desarrollador