PageBreak — Aspose.Cells FOSS for Python API Reference
aspose-cells-foss позволява вмъкване на ръчно зададени прекъсвания на страници, за да се контролира как листът се разделя върху отпечатаните страници. Хоризонталните прекъсвания на страници разделят листа между редовете; вертикалните прекъсвания разделят листа между колоните. И двете колекции използват 0-based indices.
Example: 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
Достъпно като ws.horizontal_page_breaks. Хоризонтално прекъсване на страница, вмъкнато преди ред n причинява листът да започне нова страница на този ред при печат.
Всички препратки към редове са 0-based (ред 0 = ред 1 в Excel).
Example
aspose-cells-foss предоставя импортиране и експортиране на CSV чрез класа CSVHandler и два съпътстващи класа за опции. На модулно ниво са налични удобни функции за прости случаи на употреба.
hpb.add(row_or_cell: int | str) -> intДобавя прекъсване на страница преди зададения ред. Връща 0-базирания индекс на новото прекъсване в колекцията.
| Example | Example | Example |
|---|---|---|
row_or_cell | int | 0-based row index at which to insert the break. |
row_or_cell | str | Клетъчна препратка в стил A1; редът на тази клетка се използва (например,., "A11" → прекъсване преди ред 10 в 0-базирани термини). |
remove
hpb.remove(row_or_cell: int | str)Премахва прекъсването на страница, свързано с дадения индекс на ред или препратка към клетка.
remove_at
hpb.remove_at(index: int)Премахва прекъсването на страница на дадената 0-базирана позиция в колекцията.
API справка за CipherAlgorithm, HashAlgorithm, AgileEncryptionParameters, StandardEncryptionParameters и функциите на модула за криптиране в aspose-cells-foss.
hpb.clear()Премахва всички хоризонтални прекъсвания на страници от работния лист.
to_list
hpb.to_list() -> listВръща обикновен Python списък от текущите индекси на редовете с прекъсвания (0-базирани цели числа), сортирани във възходящ ред.
API справка за CSVHandler, CSVLoadOptions, CSVSaveOptions и модулно‑ниво CSV функции в aspose-cells-foss.
| Example | Example |
|---|---|
count | Брой хоризонтални прекъсвания на страници (само за четене). |
__len__() | Example count. |
__iter__() | Итерара през индексите на редовете за прекъсване. |
__getitem__(index) | Връща индекса на реда за прекъсване на позиция index в колекцията. |
VerticalPageBreakCollection
Достъпва се като ws.vertical_page_breaks. Вертикално прекъсване на страница, вмъкнато преди колоната n причинява листът да започне нова страница на тази колона при печат.
Всички препратки към колони са 0-based (колона 0 = колона A).
Example
aspose-cells-foss предоставя импортиране и експортиране на CSV чрез класа CSVHandler и два съпътстващи класа за опции. На модулно ниво са налични удобни функции за прости случаи на употреба.
vpb.add(column_or_cell: int | str) -> intДобавя прекъсване на страница преди зададената колона. Връща 0-базирания индекс на новото прекъсване в колекцията.
| Example | Example | Example |
|---|---|---|
column_or_cell | int | 0-based column index at which to insert the break. |
column_or_cell | str | A1-стил препратка към клетка; се използва колоната на тази клетка (например,., "E1" → прекъсване преди колона 4 в 0-базирани термини). |
remove
vpb.remove(column_or_cell: int | str)Премахва прекъсването на страница, свързано с дадения индекс на колона или препратка към клетка.
API справка за CipherAlgorithm, HashAlgorithm, AgileEncryptionParameters, StandardEncryptionParameters и функциите на модула за криптиране в aspose-cells-foss.
vpb.clear()Премахва всички вертикални прекъсвания на страници от работния лист.
to_list
vpb.to_list() -> listВръща обикновен Python списък с текущите индекси на колоните за прекъсване (цели числа, започващи от 0), сортирани във възходящ ред.
API справка за CSVHandler, CSVLoadOptions, CSVSaveOptions и модулно‑ниво CSV функции в aspose-cells-foss.
| Example | Example |
|---|---|
count | Брой вертикални прекъсвания на страници (само за четене). |
__len__() | Example count. |
__iter__() | Итерира върху индексите на колоните за прекъсване. |
__getitem__(index) | Връща индекса на колоната за прекъсване на позиция index в колекцията. |
Example
Следният пример вмъква хоризонтални прекъсвания на страници на всеки 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")