PageBreak — Aspose.Cells FOSS for Python API Reference
aspose-cells-foss omogućuje umetanje ručnih prijeloma stranice kako bi se kontroliralo kako se radni list dijeli na ispisanim stranicama. Horizontalni prijelomi stranice dijele list između redaka; vertikalni prijelomi stranice dijele ga između stupaca. Obje kolekcije koriste 0-based indices.
ColladaSaveOptions: 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_breaksHorizontalPageBreakCollection
Pristupa se kao ws.horizontal_page_breaks. Horizontalni prijelom stranice umetnut prije retka n prouzrokuje da list započne novu stranicu na tom retku prilikom ispisa.
Sve reference na retke su 0-based (redak 0 = redak 1 u Excelu).
ColladaSaveOptions
add
hpb.add(row_or_cell: int | str) -> intAPI referenca za MsoDrawingType, FillType, MsoLineDashStyle, TextAlignmentType, TextAnchorType, MsoFillFormat, MsoLineFormat, ShapeFont, Shape i ShapeCollection u aspose-cells-foss.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
row_or_cell | int | 0-based row index at which to insert the break. |
row_or_cell | str | Referenca na ćeliju u stilu A1; redak te ćelije se koristi (npr., "A11" → prijelom prije retka 10 u terminima s nulom). |
Svojstva i iteracija
hpb.remove(row_or_cell: int | str)aspose-cells-foss podržava dodavanje geometrijskih oblika i tekstualnih okvira u radne listove putem ShapeCollection (ws.shapes). Svaki oblik predstavlja objekt Shape s konfigurabilnim svojstvima ispune, linije i teksta.
remove_at
hpb.remove_at(index: int)MsoDrawingType je IntEnum koji identificira vrstu geometrijskog oblika.
Methods
hpb.clear()FillType je IntEnum koji identificira vrstu ispune primijenjene na oblik.
to_list
hpb.to_list() -> listTextAlignmentType je IntEnum za vodoravno poravnavanje teksta unutar oblika.
CSVHandler.save_csv_to_string
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
count | Broj horizontalnih prijeloma stranice (samo za čitanje). |
__len__() | ColladaSaveOptions count. |
__iter__() | Iterira kroz indekse redaka prijeloma. |
__getitem__(index) | Vraća indeks redka prijeloma na položaju index u kolekciji. |
VerticalPageBreakCollection
Pristupa se kao ws.vertical_page_breaks. Vertikalni prijelom stranice umetnut prije stupca n prouzrokuje da list započne novu stranicu na tom stupcu prilikom ispisa.
Sve reference na stupce su 0-based (stupac 0 = stupac A).
ColladaSaveOptions
add
vpb.add(column_or_cell: int | str) -> intVraća duboku kopiju ovih postavki ispune.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
column_or_cell | int | 0-based column index at which to insert the break. |
column_or_cell | str | A1-stil referenca na ćeliju; koristi se stupac ove ćelije (npr., "E1" → prekid prije stupca 4 u 0‑baziranim pojmovima). |
Svojstva i iteracija
vpb.remove(column_or_cell: int | str)Upravlja izgledom obrisa/ruba oblika. Pristupa se putem shape.line.
Methods
vpb.clear()Vraća duboku kopiju ovih postavki linije.
to_list
vpb.to_list() -> listVraća duboku kopiju ovih postavki fonta.
CSVHandler.save_csv_to_string
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
count | Broj okomitih prekida stranice (samo za čitanje). |
__len__() | ColladaSaveOptions count. |
__iter__() | Iterira kroz indekse stupaca prekida. |
__getitem__(index) | Vraća indeks stupca prekida na položaju index u kolekciji. |
ColladaSaveOptions
Objekti Shape se ne konstruiraju izravno. Koristite ws.shapes.add(...) ili ws.shapes.add_text_box(...).
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")Vraća duboku kopiju ovog oblika s očuvanim svim formatiranjem.
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")