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 encryption

Properties

أضف مخططات إلى ورقة عمل باستخدام 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_map

Properties

أضف أشكال الرسم ومربعات النص إلى ورقة عمل باستخدام 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")
PropertiesPropertiesProperties
Workbookدفتر العملكائن دفتر العمل الجذر
Worksheetورقة عملورقة عمل واحدة تحتوي على خلايا، مخططات، أشكال
Cellsخلايامجموعة خلايا مع الوصول إلى A1 والوصول القائم على 1 (صف، عمود)
Cellخليةخلية واحدة: القيمة، الصيغة، النمط
Styleنمطتنسيق الخلية: الخط، التعبئة، الحدود، المحاذاة
Chartمخططمخطط مدمج
DataValidationالتحقق من صحة البياناتقاعدة التحقق من نطاق الخلايا
CSVHandlerمعالج csvاستيراد/تصدير CSV
MarkdownHandlerمعالج markdownتصدير Markdown
JsonHandlerمعالج jsonتصدير JSON
Shapeشكلرسم شكل أو مربع نص
Tableجدولجدول Excel منظم
SparklineGroupsparklineمخططات 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

انظر أيضًا

 العربية