PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss permite inserir quebras de página manuais para controlar como uma planilha é dividida nas páginas impressas. Quebras de página horizontais dividem a planilha entre linhas; quebras de página verticais dividem-na entre colunas. Ambas as coleções usam 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

Acessado como ws.horizontal_page_breaks. Uma quebra de página horizontal inserida antes da linha n faz com que a planilha inicie uma nova página nessa linha ao imprimir.

Todas as referências de linha são 0-based (linha 0 = linha 1 no Excel).

ImageRenderOptions

adicionar

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

Adiciona uma quebra de página antes da linha especificada. Retorna o índice baseado em zero da nova quebra na coleção.

remover

hpb.remove(row_or_cell: int | str)

Remove a quebra de página associada ao índice de linha ou referência de célula fornecidos.

remove_at

hpb.remove_at(index: int)

Remove a quebra de página na posição baseada em zero fornecida na coleção.

limpar

hpb.clear()

Remove todas as quebras de página horizontais da planilha.

to_list

hpb.to_list() -> list

Retorna uma lista Python simples dos índices de linha das quebras atuais (inteiros baseados em zero), ordenada em ordem crescente.

Propriedades e Iteração

VerticalPageBreakCollection

Acessado como ws.vertical_page_breaks. Uma quebra de página vertical inserida antes da coluna n faz com que a planilha inicie uma nova página nessa coluna ao imprimir.

Todas as referências de coluna são 0-based (coluna 0 = coluna A).

ImageRenderOptions

adicionar

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

Adiciona uma quebra de página antes da coluna especificada. Retorna o índice baseado em zero da nova quebra na coleção.

remover

vpb.remove(column_or_cell: int | str)

Remove a quebra de página associada ao índice de coluna ou referência de célula fornecidos.

limpar

vpb.clear()

Remove todas as quebras de página verticais da planilha.

to_list

vpb.to_list() -> list

Retorna uma lista Python simples dos índices de coluna das quebras atuais (inteiros baseados em zero), ordenada em ordem crescente.

Propriedades e Iteração

ImageRenderOptions

O exemplo a seguir insere quebras de página horizontais a cada 30 linhas para produzir páginas de impressão divididas uniformemente em um relatório 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")

Removendo uma Quebra Específica

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

Veja Também

• Cells Python Referência da API início
• Referência da classe Workbook
• Referência da classe Worksheet
• Introdução
• Guia do Desenvolvedor