Cells
Python
PageBreak

PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss membenarkan penyisipan pemisah halaman manual untuk mengawal bagaimana helaian kerja dibahagikan ke dalam halaman cetakan. Pemisah halaman mendatar memisahkan helaian antara baris; pemisah halaman menegak memisahkannya antara lajur. Kedua-dua koleksi menggunakan 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

Diakses sebagai ws.horizontal_page_breaks. Pemisah halaman mendatar yang disisipkan sebelum baris n menyebabkan helaian memulakan halaman baru pada baris tersebut apabila dicetak.

Semua rujukan baris adalah 0-based (baris 0 = baris 1 dalam Excel).

ImageRenderOptions

add 

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

Menambah pemisah halaman sebelum baris yang ditentukan. Mengembalikan indeks berasaskan 0 bagi pemisah baru dalam koleksi.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
row_or_cellint0-based row index at which to insert the break.
row_or_cellstrRujukan sel gaya A1; baris sel ini digunakan (contohnya,., "A11" → pemisah sebelum baris 10 dalam istilah berasaskan 0).

remove 

hpb.remove(row_or_cell: int | str)

Membuang pemisah halaman yang berkaitan dengan indeks baris atau rujukan sel yang diberikan.

remove_at 

hpb.remove_at(index: int)

Membuang pemisah halaman pada kedudukan berasaskan 0 yang diberikan dalam koleksi.

clear 

hpb.clear()

Membuang semua pemisah halaman mendatar dari helaian kerja.

to_list 

hpb.to_list() -> list

Mengembalikan senarai Python biasa bagi indeks baris pemisah semasa (integer berasaskan 0), disusun dalam susunan menaik.

Sifat dan Iterasi

ImageRenderOptionsImageRenderOptions
countBilangan pemisah halaman mendatar (baca-sahaja).
__len__()ImageRenderOptions count.
__iter__()Mengulangi indeks baris pemisah.
__getitem__(index)Mengembalikan indeks baris pecahan pada kedudukan index dalam koleksi.

VerticalPageBreakCollection

Diakses sebagai ws.vertical_page_breaks. Pecahan halaman menegak yang dimasukkan sebelum lajur n menyebabkan helaian memulakan halaman baru pada lajur tersebut apabila dicetak.

Semua rujukan lajur adalah 0-based (lajur 0 = lajur A).

ImageRenderOptions

add 

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

Menambah pecahan halaman sebelum lajur yang ditentukan. Mengembalikan indeks berasaskan sifar bagi pecahan baru dalam koleksi.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
column_or_cellint0-based column index at which to insert the break.
column_or_cellstrRujukan sel gaya A1; lajur sel ini digunakan (contohnya,., "E1" → pecah sebelum lajur 4 dalam istilah berasaskan 0).

remove 

vpb.remove(column_or_cell: int | str)

Membuang pecahan halaman yang berkaitan dengan indeks lajur atau rujukan sel yang diberikan.

clear 

vpb.clear()

Membuang semua pecahan halaman menegak daripada helaian kerja.

to_list 

vpb.to_list() -> list

Mengembalikan senarai Python biasa bagi indeks lajur pecahan semasa (integer berasaskan 0), disusun dalam susunan menaik.

Sifat dan Iterasi

ImageRenderOptionsImageRenderOptions
countBilangan pecahan halaman menegak (baca-sahaja).
__len__()ImageRenderOptions count.
__iter__()Melakukan iterasi ke atas indeks lajur pecah.
__getitem__(index)Mengembalikan indeks lajur pecah pada kedudukan index dalam koleksi.

ImageRenderOptions

Contoh berikut menyisipkan pecahan halaman melintang setiap 30 baris untuk menghasilkan halaman cetakan yang dibahagikan secara merata pada laporan besar.

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

Membuang Pecahan Khusus 

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

Lihat Juga

 Bahasa Melayu