Cells
Python
PageBreak

PageBreak — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss, bir çalışma sayfasının yazdırılan sayfalara nasıl bölüneceğini kontrol etmek için manuel sayfa sonları eklemeye izin verir. Yatay sayfa sonları sayfayı satırlar arasında böler; dikey sayfa sonları ise sütunlar arasında böler. Her iki koleksiyon da kullanır 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

Şu şekilde erişilir ws.horizontal_page_breaks. Bir satırdan önce eklenen yatay sayfa sonu n yazdırıldığında sayfanın o satırda yeni bir sayfaya başlamasına neden olur.

Tüm satır referansları 0-based (satır 0 = Excel’de satır 1).

Enumerations

add 

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

Belirtilen satırdan önce bir sayfa sonu ekler. Yeni sonucun koleksiyondaki sıfır tabanlı indeksini döndürür.

EnumerationsEnumerationsEnumerations
row_or_cellint0-based row index at which to insert the break.
row_or_cellstrA1 stili hücre referansı; bu hücrenin satırı kullanılır (örneğin,., "A11" → 0 tabanlı terimlerde satır 10’dan önce kesme).

remove 

hpb.remove(row_or_cell: int | str)

Verilen satır indeksi veya hücre referansı ile ilişkili sayfa sonunu kaldırır.

remove_at 

hpb.remove_at(index: int)

Koleksiyondaki verilen sıfır tabanlı konumdaki sayfa sonunu kaldırır.

clear 

hpb.clear()

Çalışma sayfasındaki tüm yatay sayfa sonlarını kaldırır.

to_list 

hpb.to_list() -> list

Mevcut kırılma satır indekslerinin (0 tabanlı tam sayılar) düz bir Python listesini döndürür, artan sırada sıralanmış.

Özellikler ve Yineleme

EnumerationsEnumerations
countYatay sayfa sonlarının sayısı (yalnızca okunabilir).
__len__()Enumerations count.
__iter__()Kesme satır indeksleri üzerinde yineleme yapar.
__getitem__(index)Pozisyondaki break row index’i döndürür index koleksiyonda.

VerticalPageBreakCollection

Şu şekilde erişilir ws.vertical_page_breaks. Sütundan önce eklenen dikey sayfa kesmesi n Sayfa, yazdırıldığında o sütunda yeni bir sayfaya başlamasına neden olur.

Tüm sütun referansları şunlardır 0-based (sütun 0 = sütun A).

Enumerations

add 

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

Belirtilen sütundan önce bir sayfa sonu ekler. Yeni sonucun koleksiyondaki sıfır tabanlı indeksini döndürür.

EnumerationsEnumerationsEnumerations
column_or_cellint0-based column index at which to insert the break.
column_or_cellstrA1 tarzı hücre referansı; bu hücrenin sütunu kullanılır (örneğin,., "E1" → 0 tabanlı terimlerde sütun 4’ten önce kesinti).

remove 

vpb.remove(column_or_cell: int | str)

Verilen sütun indeksi veya hücre referansı ile ilişkili sayfa sonunu kaldırır.

clear 

vpb.clear()

Çalışma sayfasındaki tüm dikey sayfa sonlarını kaldırır.

to_list 

vpb.to_list() -> list

Mevcut kesme sütun indekslerinin (0 tabanlı tam sayılar) düz bir Python listesini döndürür, artan sırada sıralanmış.

Özellikler ve Yineleme

EnumerationsEnumerations
countDikey sayfa kesintilerinin sayısı (salt okunur).
__len__()Enumerations count.
__iter__()Kırılma sütun indeksleri üzerinde yineleme yapar.
__getitem__(index)Konumdaki kırılma sütun indeksini döndürür index koleksiyonda.

Enumerations

Aşağıdaki örnek, büyük bir raporda eşit bölünmüş baskı sayfaları oluşturmak için her 30 satırda yatay sayfa kesmeleri ekler.

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

Belirli Bir Kesmenin Kaldırılması 

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

Ayrıca Bakınız

 Türkçe