PageBreak — Aspose.Cells FOSS for Python API Reference

Το aspose-cells-foss επιτρέπει την εισαγωγή χειροκίνητων αλλαγών σελίδας για να ελέγχει πώς ένα φύλλο εργασίας διαιρείται σε εκτυπωμένες σελίδες. Οι οριζόντιες αλλαγές σελίδας χωρίζουν το φύλλο μεταξύ των γραμμών· οι κάθετες αλλαγές σελίδας το χωρίζουν μεταξύ των στηλών. Και οι δύο συλλογές χρησιμοποιούν 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

Πρόσβαση ως ws.horizontal_page_breaks. Μια οριζόντια αλλαγή σελίδας που εισάγεται πριν από τη γραμμή n προκαλεί το φύλλο να ξεκινήσει νέα σελίδα σε αυτή τη γραμμή κατά την εκτύπωση.

Όλες οι αναφορές γραμμών είναι 0-based (γραμμή 0 = γραμμή 1 στο Excel).

ImageRenderOptions

add

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

Προσθέτει μια αλλαγή σελίδας πριν από τη συγκεκριμένη γραμμή. Επιστρέφει τον δείκτη μηδενικής βάσης της νέας αλλαγής στη συλλογή.

remove

hpb.remove(row_or_cell: int | str)

Αφαιρεί την αλλαγή σελίδας που σχετίζεται με τον δεδομένο δείκτη γραμμής ή την αναφορά κελιού.

remove_at

hpb.remove_at(index: int)

Αφαιρεί την αλλαγή σελίδας στη δεδομένη θέση μηδενικής βάσης στη συλλογή.

clear

hpb.clear()

Αφαιρεί όλες τις οριζόντιες αλλαγές σελίδας από το φύλλο εργασίας.

to_list

hpb.to_list() -> list

Επιστρέφει μια απλή λίστα Python των τρεχουσών δεικτών γραμμών αλλαγής (ακέραιοι μηδενικής βάσης), ταξινομημένη σε αύξουσα σειρά.

Ιδιότητες και Επανάληψη

VerticalPageBreakCollection

Πρόσβαση ως ws.vertical_page_breaks. Μια κάθετη αλλαγή σελίδας που εισάγεται πριν από τη στήλη n προκαλεί το φύλλο να ξεκινήσει νέα σελίδα σε αυτή τη στήλη κατά την εκτύπωση.

Όλες οι αναφορές στηλών είναι 0-based (στήλη 0 = στήλη A).

ImageRenderOptions

add

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

Προσθέτει ένα διάλειμμα σελίδας πριν από τη συγκεκριμένη στήλη. Επιστρέφει το μηδενικό (zero‑based) δείκτη του νέου διαλείμματος στη συλλογή.

remove

vpb.remove(column_or_cell: int | str)

Αφαιρεί το διάλειμμα σελίδας που σχετίζεται με τον δεδομένο δείκτη στήλης ή την αναφορά κελιού.

clear

vpb.clear()

Αφαιρεί όλα τα κάθετα διαλείμματα σελίδας από το φύλλο εργασίας.

to_list

vpb.to_list() -> list

Επιστρέφει μια απλή λίστα Python των τρεχουσών δεικτών στήλης διαλείμματος (ακέραιοι 0‑based), ταξινομημένη σε αύξουσα σειρά.

Ιδιότητες και Επανάληψη

ImageRenderOptions

Το παρακάτω παράδειγμα εισάγει οριζόντια διαλείμματα σελίδας κάθε 30 γραμμές για να παράγει ομοιόμορφα κατανεμημένες σελίδες εκτύπωσης σε μια μεγάλη αναφορά.

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

Αφαίρεση ενός Συγκεκριμένου Διαλείμματος

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

Δείτε επίσης

• Cells Python Αναφορά API αρχική
• Αναφορά κλάσης Workbook
• Αναφορά κλάσης Worksheet
• Ξεκινώντας
• Οδηγός Προγραμματιστή