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
CSVHandler يحتوي فقط على طرق ثابتة ولا يتم إنشاء مثيل له أبداً.
hpb.add(row_or_cell: int | str) -> intيضيف فاصل صفحة قبل الصف المحدد. يُرجع الفهرس الذي يبدأ من الصفر للفاصل الجديد في المجموعة.
| Example | Example | Example |
|---|---|---|
row_or_cell | int | 0-based row index at which to insert the break. |
row_or_cell | str | مرجع خلية بنمط A1؛ يُستخدم صف هذه الخلية (مثالاً،., "A11" → فاصل قبل الصف 10 بمصطلحات الصفرية). |
يدعم aspose-cells-foss تشفير وفك تشفير ملفات XLSX باستخدام AES عبر وظائف المستوى الوحدة encrypt_xlsx و decrypt_xlsx. فئتا المعاملات تُكوّنان خوارزمية الشيفرة، خوارزمية التجزئة، وعدد دورات PBKDF2. الإعداد الافتراضي الموصى به هو AgileEncryptionParameters مع AES-256 و SHA-512.
hpb.remove(row_or_cell: int | str)يزيل فاصل الصفحة المرتبط بمؤشر الصف المعطى أو مرجع الخلية.
remove_at
hpb.remove_at(index: int)يزيل فاصل الصفحة في الموضع الذي يبدأ من الصفر في المجموعة.
MarkdownSaveOptions لا يحتوي على خصائص قابلة للتكوين. مرّر مثيلاً إلى MarkdownHandler.save_markdown() لاستخدام سلوك التسلسل الافتراضي.
hpb.clear()يزيل جميع فواصل الصفحات الأفقية من ورقة العمل.
to_list
hpb.to_list() -> listيرجع قائمة Python عادية لمؤشرات صفوف الفواصل الحالية (أعداد صحيحة تبدأ من الصفر)، مرتبة بترتيب تصاعدي.
البدء
| Example | Example |
|---|---|
count | عدد فواصل الصفحات الأفقية (للقراءة فقط). |
__len__() | Example count. |
__iter__() | يتكرر عبر مؤشرات صف الفاصل. |
__getitem__(index) | يعيد فهرس صف الفاصل في الموضع index في المجموعة. |
VerticalPageBreakCollection
يتم الوصول إليه كـ ws.vertical_page_breaks. فاصل صفحة عمودي يُدرج قبل العمود n يتسبب في بدء الورقة صفحة جديدة عند ذلك العمود عند الطباعة.
جميع مراجع الأعمدة هي 0-based (العمود 0 = العمود A).
Example
CSVHandler يحتوي فقط على طرق ثابتة ولا يتم إنشاء مثيل له أبداً.
vpb.add(column_or_cell: int | str) -> intيضيف فاصل صفحة قبل العمود المحدد. يُرجع الفهرس الذي يبدأ من الصفر للفاصل الجديد في المجموعة.
| Example | Example | Example |
|---|---|---|
column_or_cell | int | 0-based column index at which to insert the break. |
column_or_cell | str | مرجع خلية بنمط A1؛ يُستخدم عمود هذه الخلية (مثالاً،., "E1" → فاصل قبل العمود 4 بمصطلحات صفرية). |
يدعم aspose-cells-foss تشفير وفك تشفير ملفات XLSX باستخدام AES عبر وظائف المستوى الوحدة encrypt_xlsx و decrypt_xlsx. فئتا المعاملات تُكوّنان خوارزمية الشيفرة، خوارزمية التجزئة، وعدد دورات PBKDF2. الإعداد الافتراضي الموصى به هو AgileEncryptionParameters مع AES-256 و SHA-512.
vpb.remove(column_or_cell: int | str)يزيل فاصل الصفحة المرتبط بمؤشر العمود المعطى أو مرجع الخلية.
MarkdownSaveOptions لا يحتوي على خصائص قابلة للتكوين. مرّر مثيلاً إلى MarkdownHandler.save_markdown() لاستخدام سلوك التسلسل الافتراضي.
vpb.clear()يزيل جميع فواصل الصفحات العمودية من ورقة العمل.
to_list
vpb.to_list() -> listReturns a plain Python list of the current break column indices (0-based integers), sorted in ascending order.
البدء
| Example | Example |
|---|---|
count | عدد فواصل الصفحات العمودية (للقراءة فقط). |
__len__() | Example count. |
__iter__() | يتنقل عبر مؤشرات أعمدة الفاصل. |
__getitem__(index) | يرجع مؤشر عمود الفاصل في الموضع index في المجموعة. |
Example
The following example inserts horizontal page breaks every 30 rows to produce evenly divided print pages on a large report.
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")Removing a Specific Break
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")