Aspose.Cells FOSS API Reference
Properties
Aspose.Cells FOSS is an open-source Python library for creating, reading, and modifying spreadsheet files without requiring Microsoft Excel. It supports XLSX and CSV formats for input, and adds Markdown export via save_as_markdown(). المكتبة مُنظمة حول a Workbook كائن الجذر الذي يدير أوراق العمل، الأنماط، المخططات، و I/O.
نقطة الدخول الأساسية هي Workbook.كل Workbook يحتوي على واحد أو أكثر Worksheet كائنات يتم الوصول إليها عبر wb.worksheets[index]. الخلايا الفردية يتم الوصول إليها عبر Cells مجموعة باستخدام تدوين A1 أو مؤشرات الصف/العمود التي تبدأ من الصفر.
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].value = "Revenue"
ws.cells["B2"].value = 42
wb.save("output.xlsx")Workbook و Worksheet
Properties Workbook class هو كائن الجذر لجميع عمليات الجداول الإلكترونية. يتعامل مع تحميل الملفات، حفظها، والوصول إلى أوراق العمل وخصائص المستند.
from aspose.cells_foss import Workbook
wb = Workbook() # new workbook
wb = Workbook("input.xlsx") # open existing file
wb = Workbook("protected.xlsx", password="secret") # open encrypted file
ws = wb.worksheets[0] # first worksheet (0-based)
ws = wb.add_worksheet("Sheet2") # add a named worksheet
ws.cells["A1"].put_value("Hello") # write by A1 reference
ws.cells["A1"].value # read value (property, no parentheses)
ws.cells["A2"].formula = "=SUM(B1:B5)"
wb.save("output.xlsx") # save as XLSX
wb.save("output.csv") # auto-detects format from extension
wb.save_as_markdown("output.md") # export as Markdown table
wb.save("output.xlsx", password="secret") # save with AES encryptionProperties
أضف مخططات إلى ورقة عمل باستخدام the add_* الطرق على ws.charts. كل طريقة تأخذ أربعة وسائط موضعية: top_row, left_col, bottom_row, right_col. الوصول إلى المخطط بواسطة الفهرس لتعيين عنوانه وسلسلة البيانات.
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
chart_idx = ws.charts.add_line(upper_left_row=0, upper_left_col=4,
lower_right_row=20, lower_right_col=12)
chart = ws.charts[chart_idx]
chart.title = "Monthly Sales"
chart.n_series.add("B2:B7", category_data="A2:A7", name="Sales")
# Other add methods: add_bar, add_pie, add_area, add_scatter,
# add_waterfall, add_combo, add_stock, add_surface, add_radar,
# add_treemap, add_sunburst, add_histogram, add_funnel,
# add_box_whisker, add_mapProperties
أضف أشكال الرسم ومربعات النص إلى ورقة عمل باستخدام ws.shapes.
from aspose.cells_foss import Workbook
from aspose.cells_foss import MsoDrawingType, TextAlignmentType, TextAnchorType
wb = Workbook()
ws = wb.worksheets[0]
shape = ws.shapes.add(MsoDrawingType.ROUNDED_RECTANGLE, 1, 1, 5, 5)
shape.text = "Hello"
shape.fill.fore_color = "90EE90"
shape.font.bold = True
shape.text_horizontal_alignment = TextAlignmentType.CENTER
shape.text_vertical_alignment = TextAnchorType.MIDDLE
textbox = ws.shapes.add_text_box(7, 1, 11, 8)
textbox.text = "Notes"قيم الخلايا والأنماط
قراءة وكتابة قيم الخلايا باستخدام .value خاصية. عدّل التنسيق بالوصول إلى cell.style مباشرةً.
from aspose.cells_foss import Workbook
workbook = Workbook()
worksheet = workbook.worksheets[0]
# Write values
worksheet.cells["A1"].value = "Hello"
worksheet.cells["B1"].value = "World"
worksheet.cells["A2"].value = 42
worksheet.cells["B2"].value = 3.14
# Read a value
value = worksheet.cells["A1"].value
print(f"Cell A1 contains: {value}")
# Apply a style via the cell's style property
cell = worksheet.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FF0000" # RRGGBB hex, no # prefix
cell.style.set_horizontal_alignment("center")
cell.style.set_number_format("#,##0.00")
cell.style.set_border("bottom", line_style="thin")
workbook.save("output.xlsx")ملاحظة: عند تعيين font.color, استخدم سلسلة سداسية عشرية بدون # بادئة (مثال،., "FF0000" للون الأحمر).
التحقق من صحة البيانات
أضف قائمة منسدلة أو قواعد تحقق أخرى إلى نطاق خلايا باستخدام ws.data_validations.
from aspose.cells_foss import Workbook, DataValidationType
workbook = Workbook()
worksheet = workbook.worksheets[0]
validation = worksheet.data_validations.add("A1:A10")
validation.type = DataValidationType.LIST
validation.formula1 = '"Option1,Option2,Option3"'
workbook.save("validation.xlsx")Properties
احفظ أو افتح دفاتر عمل محمية بكلمة مرور:
from aspose.cells_foss import Workbook
workbook = Workbook()
worksheet = workbook.worksheets[0]
worksheet.cells["A1"].value = "Confidential Data"
# Save with password protection
workbook.save("protected.xlsx", password="mypassword")
# Open a password-protected file
workbook2 = Workbook("protected.xlsx", password="mypassword")API العامة
Properties Cells توفر الفئة إمكانية الوصول إلى الخلايا الفردية باستخدام تدوين النمط A1 (مثالاً،., "A1") أو مؤشرات الصف/العمود التي تبدأ من 1. الـ Cell تمثل الفئة خلية واحدة وتكشف عن value, formula,، و style كخصائص للقراءة والكتابة. يتم دعم دمج وفك دمج الخلايا عبر merge() و unmerge() طرق على Cells.
from aspose.cells_foss import Workbook
workbook = Workbook()
worksheet = workbook.worksheets[0]
worksheet.cells["A1"].value = "Hello"
worksheet.cells["B1"].value = "World" # A1 notation preferred
workbook.save("output.xlsx")| Properties | Properties | Properties |
|---|---|---|
Workbook | دفتر العمل | كائن دفتر العمل الجذر |
Worksheet | ورقة عمل | ورقة عمل واحدة تحتوي على خلايا، مخططات، أشكال |
Cells | خلايا | مجموعة خلايا مع الوصول إلى A1 والوصول القائم على 1 (صف، عمود) |
Cell | خلية | خلية واحدة: القيمة، الصيغة، النمط |
Style | نمط | تنسيق الخلية: الخط، التعبئة، الحدود، المحاذاة |
Chart | مخطط | مخطط مدمج |
DataValidation | التحقق من صحة البيانات | قاعدة التحقق من نطاق الخلايا |
CSVHandler | معالج csv | استيراد/تصدير CSV |
MarkdownHandler | معالج markdown | تصدير Markdown |
JsonHandler | معالج json | تصدير JSON |
Shape | شكل | رسم شكل أو مربع نص |
Table | جدول | جدول Excel منظم |
SparklineGroup | sparkline | مخططات Sparkline |
HorizontalPageBreakCollection | فاصل صفحة | فواصل صفحات يدوية |
AgileEncryptionParameters | تشفير | معلمات تشفير AES |
SaveFormat | دفتر عمل | تنسيق الإخراج enum |
الأنماط الشائعة
# Styling a cell
cell = ws.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FF0000" # red (RRGGBB, no #)
cell.style.set_horizontal_alignment("center")
cell.style.set_number_format("#,##0.00")
cell.style.set_border("bottom", line_style="thin")# Add a dropdown validation
from aspose.cells_foss import DataValidationType
dv = ws.data_validations.add("B1:B10")
dv.type = DataValidationType.LIST
dv.formula1 = '"Red,Green,Blue"'
dv.show_dropdown = True