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

מוסיף שבירת עמוד לפני השורה המצוינת. מחזיר את האינדקס מבוסס‑0 של השבירה החדשה באוסף.

remove

hpb.remove(row_or_cell: int | str)

מסיר את שבירת העמוד המשויכת לאינדקס השורה או להתייחסות התא הנתונה.

remove_at

hpb.remove_at(index: int)

מסיר את שבירת העמוד במיקום מבוסס‑0 הנתון באוסף.

clear

hpb.clear()

מסיר את כל שבירות העמוד האופקיות מהגיליון.

to_list

hpb.to_list() -> list

מחזיר רשימה פשוטה של Python של אינדקסי השורות של השבירות הנוכחיות (מספרים שלמים מבוססי‑0), ממוינת בסדר עולה.

מאפיינים ואיטרציה

VerticalPageBreakCollection

נגישים כ ws.vertical_page_breaks. שבירת עמוד אנכית המוכנסת לפני העמודה n גורמת לגיליון להתחיל דף חדש באותה עמודה בעת ההדפסה.

כל ההתייחסויות לעמודות הן 0-based (עמודה 0 = עמודה A).

ImageRenderOptions

add

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

מוסיף שבירת עמוד לפני העמוד המצויין. מחזיר את האינדקס מבוסס-0 של השבירה החדשה באוסף.

remove

vpb.remove(column_or_cell: int | str)

מסיר את שבירת העמוד המשויכת לאינדקס העמוד או להתייחסות התא הנתונה.

clear

vpb.clear()

מסיר את כל שבירות העמוד האנכיות מהגיליון.

to_list

vpb.to_list() -> list

מחזיר רשימה פשוטה של Python של אינדקסי העמודות של השבירות הנוכחיות (מספרים שלמים מבוססי-0), ממוינת בסדר עולה.

מאפיינים ואיטרציה

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

ראה גם

• תאים Python API Reference דף הבית
• תיעוד מחלקת Workbook
• התייחסות למחלקת Worksheet
• התחלה
• מדריך למפתחים