PageBreak — Aspose.Cells FOSS for Python API Reference
aspose-cells-foss permet d’insérer des sauts de page manuels pour contrôler la façon dont une feuille de calcul est divisée sur les pages imprimées. Les sauts de page horizontaux divisent la feuille entre les lignes ; les sauts de page verticaux la divisent entre les colonnes. Les deux collections utilisent 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_breaksHorizontalPageBreakCollection
Accédé en tant que ws.horizontal_page_breaks. Un saut de page horizontal inséré avant la ligne n fait que la feuille commence une nouvelle page à cette ligne lors de l’impression.
Toutes les références de ligne sont 0-based (ligne 0 = ligne 1 dans Excel).
Examples
add
hpb.add(row_or_cell: int | str) -> intAjoute un saut de page avant la ligne spécifiée. Retourne l’indice à base zéro du nouveau saut dans la collection.
| Examples | Examples | Examples |
|---|---|---|
row_or_cell | int | 0-based row index at which to insert the break. |
row_or_cell | str | Référence de cellule de style A1 ; la ligne de cette cellule est utilisée (p. ex., "A11" → saut avant la ligne 10 en termes indexés à 0). |
remove
hpb.remove(row_or_cell: int | str)Supprime le saut de page associé à l’index de ligne ou à la référence de cellule fournis.
remove_at
hpb.remove_at(index: int)Supprime le saut de page à la position à base zéro indiquée dans la collection.
clear
hpb.clear()Supprime tous les sauts de page horizontaux de la feuille de calcul.
to_list
hpb.to_list() -> listRetourne une liste Python simple des indices de lignes de saut actuels (entiers à base zéro), triée par ordre croissant.
Propriétés et itération
| Examples | Examples |
|---|---|
count | Nombre de sauts de page horizontaux (lecture seule). |
__len__() | Examples count. |
__iter__() | Itère sur les indices de lignes de saut. |
__getitem__(index) | Renvoie l’indice de ligne de saut à la position index dans la collection. |
VerticalPageBreakCollection
Accédé comme ws.vertical_page_breaks. Un saut de page vertical inséré avant la colonne n fait que la feuille commence une nouvelle page à cette colonne lors de l’impression.
Toutes les références de colonnes sont 0-based (colonne 0 = colonne A).
Examples
add
vpb.add(column_or_cell: int | str) -> intAjoute un saut de page avant la colonne spécifiée. Retourne l’index basé sur zéro du nouveau saut dans la collection.
| Examples | Examples | Examples |
|---|---|---|
column_or_cell | int | 0-based column index at which to insert the break. |
column_or_cell | str | Référence de cellule de style A1 ; la colonne de cette cellule est utilisée (par ex., "E1" → saut avant la colonne 4 en termes indexés à 0). |
remove
vpb.remove(column_or_cell: int | str)Supprime le saut de page associé à l’index de colonne ou à la référence de cellule fournis.
clear
vpb.clear()Supprime tous les sauts de page verticaux de la feuille de calcul.
to_list
vpb.to_list() -> listRetourne une liste Python simple des indices de colonnes de saut actuels (entiers indexés à partir de 0), triée par ordre croissant.
Propriétés et itération
| Examples | Examples |
|---|---|
count | Nombre de sauts de page verticaux (lecture seule). |
__len__() | Examples count. |
__iter__() | Itère sur les indices de colonnes de saut. |
__getitem__(index) | Renvoie l’indice de colonne de saut à la position index dans la collection. |
Examples
L’exemple suivant insère des sauts de page horizontaux toutes les 30 lignes afin de produire des pages d’impression uniformément divisées dans un grand rapport.
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")Suppression d’un saut spécifique
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")