Cells
Python
PageBreak

PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss cho phép chèn ngắt trang thủ công để kiểm soát cách một worksheet được chia thành các trang khi in. Ngắt trang ngang tách sheet giữa các hàng; ngắt trang dọc tách nó giữa các cột. Cả hai bộ sưu tập đều sử dụng 0-based indices.

Enumerations: 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

Truy cập như ws.horizontal_page_breaks. Một ngắt trang ngang được chèn trước hàng n sẽ khiến sheet bắt đầu một trang mới tại hàng đó khi in.

Tất cả các tham chiếu hàng là 0-based (hàng 0 = hàng 1 trong Excel).

Enumerations

add 

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

Thêm một ngắt trang trước hàng được chỉ định. Trả về chỉ số bắt đầu từ 0 của ngắt trang mới trong bộ sưu tập.

EnumerationsEnumerationsEnumerations
row_or_cellint0-based row index at which to insert the break.
row_or_cellstrTham chiếu ô kiểu A1; hàng của ô này được sử dụng (ví dụ,., "A11" → ngắt trước hàng 10 theo cách tính dựa trên 0).

remove 

hpb.remove(row_or_cell: int | str)

Xóa ngắt trang liên quan đến chỉ số hàng hoặc tham chiếu ô đã cho.

remove_at 

hpb.remove_at(index: int)

Xóa ngắt trang tại vị trí bắt đầu từ 0 đã cho trong bộ sưu tập.

clear 

hpb.clear()

Xóa tất cả ngắt trang ngang khỏi worksheet.

to_list 

hpb.to_list() -> list

Trả về một danh sách Python thuần của các chỉ số hàng ngắt hiện tại (số nguyên bắt đầu từ 0), được sắp xếp theo thứ tự tăng dần.

Thuộc tính và Lặp lại

EnumerationsEnumerations
countSố lượng ngắt trang ngang (chỉ đọc).
__len__()Enumerations count.
__iter__()Duyệt qua các chỉ số hàng ngắt.
__getitem__(index)Trả về chỉ số hàng ngắt tại vị trí index trong bộ sưu tập.

VerticalPageBreakCollection

Truy cập như ws.vertical_page_breaks. Một ngắt trang dọc được chèn trước cột n sẽ khiến sheet bắt đầu một trang mới tại cột đó khi in.

Tất cả các tham chiếu cột là 0-based (cột 0 = cột A).

Enumerations

add 

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

Thêm một ngắt trang trước cột được chỉ định. Trả về chỉ số bắt đầu từ 0 của ngắt trang mới trong bộ sưu tập.

EnumerationsEnumerationsEnumerations
column_or_cellint0-based column index at which to insert the break.
column_or_cellstrTham chiếu ô kiểu A1; cột của ô này được sử dụng (ví dụ,., "E1" → ngắt trước cột 4 theo cách tính từ 0).

remove 

vpb.remove(column_or_cell: int | str)

Xóa ngắt trang liên quan đến chỉ số cột hoặc tham chiếu ô đã cho.

clear 

vpb.clear()

Xóa tất cả ngắt trang dọc khỏi worksheet.

to_list 

vpb.to_list() -> list

Trả về một danh sách Python đơn giản các chỉ số cột ngắt hiện tại (số nguyên bắt đầu từ 0), được sắp xếp theo thứ tự tăng dần.

Thuộc tính và Lặp lại

EnumerationsEnumerations
countSố lượng ngắt trang dọc (chỉ đọc).
__len__()Enumerations count.
__iter__()Lặp qua các chỉ số cột ngắt.
__getitem__(index)Trả về chỉ số cột ngắt tại vị trí index trong bộ sưu tập.

Enumerations

Ví dụ sau chèn các ngắt trang ngang mỗi 30 hàng để tạo các trang in được chia đều trên một báo cáo lớn.

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

Xóa một Ngắt Cụ Thể 

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

Xem Thêm

 Tiếng Việt