Aspose.Cells FOSS لـ Python

معلومات عن الحزمة


حزمة PyPI	`aspose-cells-foss`
استيراد بايثون	`from aspose.cells_foss import ...`
النسخة:	26.3.1
رخصة	MIT
متطلبات بايثون	>= 3.7
الاعتمادات	`pycryptodome>=3.15.0`, `olefile>=0.46`

وحدات

الوحدة	وصف
aspose.cells_foss	واجهة برمجة التطبيقات الأساسية للصفحات البيانية: كتب العمل، ورق عمل، خلايا، أنماط، مخططات، معالجين الصيغ

ملاحظة::لا يوجد أي شيء. aspose.pydrawing وحدة في Aspose.Cells FOSS. يتم التعبير عن الألوان كسلسلاً AARRGGBB من 8 أرقام (مثل،., "FFFF0000" للحمراء الغامضة).

aspose.cells_foss

فئات

الفئة	الصفحة	وصف
`Workbook`	كتاب عمل	نقطة الدخول لإنشاء وتحميل وحفظ ملفات جداول البيانات.
`Worksheet`	ورقة عمل	يمثل ورقة واحدة؛ يوفر الوصول إلى الخلايا والرسوم البيانية والأعمال التوضيحية.
`Cells`	الخلايا	مجموعة مثل القاموس من `Cell` كائنات داخل `Worksheet`
`Cell`	الخلية	يمثل خلية فردية؛ القيمة، الصيغة والطراز
`Style`	النمط	تنسيق الخلية: الخط، التعبئة، الحواف، المواءمة، شكل الرقم، حماية
`Font`	النمط	خصائص الخط: الاسم، الحجم، اللون، الشجاعة، التهجيّة، الإشارة إلى أسفل، الضغط خلال
`Fill`	النمط	ملء الخلفية: صلبة، منحدر أو نمط.
`NumberFormat`	النمط	أدوات البحث المدمجة في شكل رقم
`SaveFormat`	كتاب عمل	قائمة بتشكيلات النتائج المدعومة (XLSX، CSV، MARKDOWN، JSON)
`Chart`	الرسم البياني	يمثل مخطط مدمج في ورقة عمل
`ChartType`	الرسم البياني	النمط: الخط، بار، بيي، منطقة، المخزون، وأكثر من ذلك.
`NSeries`	الرسم البياني	مجموعة سلسلة بيانات على الرسم البياني
`ChartSeries`	الرسم البياني	سلسلة بيانات واحدة مع القيم، الفئات، وأشرطة الخطأ.
`ChartAxis`	الرسم البياني	إعدادات المحور: الحجم، الشكل، العنوان
`ChartView3D`	الرسم البياني	3D rotation and perspective settings
`ChartErrorBars`	الرسم البياني	تشكيل شريط الخطأ لسلسلة
`DataValidation`	التحقق من صحة البيانات	قاعدة التحقق من الصلاحية الفردية على نطاق الخلايا
`DataValidationCollection`	التحقق من صحة البيانات	جميع قواعد التحقق من صحة ورقة عمل
`DataValidationType`	التحقق من صحة البيانات	Enum: WHOLE_NUMBER، العشري، LIST، التاريخ، الوقت، TEXT_LENGTH، الخصيص
`DataValidationOperator`	التحقق من صحة البيانات	Enum: بين، متساوية، أكبر من_THAN، الخ.
`DataValidationAlertStyle`	التحقق من صحة البيانات	توقف، تحذير. INFORMATION
`CSVHandler`	جهاز التعامل مع csv	الأساليب الثابتة لتصدير بيانات CSV ومعالجة البيانات من CS V
`CSVLoadOptions`	جهاز التعامل مع csv	خيارات تحميل ملفات CSV
`CSVSaveOptions`	جهاز التعامل مع csv	خيارات حفظ ملفات CSV
`MarkdownHandler`	عامل التسجيل	طرق ثابتة للتصدير بالخفض
`MarkdownSaveOptions`	عامل التسجيل	خيارات التصدير المحدد
`JsonHandler`	(جيسون هاندلر)	طرق ثابتة لتصدير JSON
`JsonSaveOptions`	(جيسون هاندلر)	خيارات تصدير JSON
`Shape`	شكل	رسم شكل مع ملء، خط، نص، وتشكيل الخطوط
`ShapeCollection`	شكل	جميع الأشكال في ورقة عمل (`ws.shapes`)
`MsoDrawingType`	شكل	إينوم: مستطيل، بيضاوي، TEXT_BOX، ARROW، إلخ.
`Table`	الجدول	جدول Excel (مراجع منظمة) في ورقة عمل
`TableCollection`	الجدول	جميع الجداول في ورقة عمل (`ws.tables`)
`TableColumn`	الجدول	تعريف العمود داخل الجدول
`TableStyleInfo`	الجدول	إعدادات الأسلوب المرئي للجدول
`SparklineGroup`	النور المشرق	مجموعة من الرسوم البيانية التي تتشارك أسلوبًا مرئيًًة.
`SparklineGroupCollection`	النور المشرق	جميع مجموعات النور (`ws.sparkline_groups`)
`Sparkline`	النور المشرق	خلية واحدة متصلة بمجموعة بيانات
`SparklineType`	النور المشرق	النمط: الخط، العمود، WIN_LOSS
`HorizontalPageBreakCollection`	إفصاح الصفحة	كسر الصفحة الأفقية اليدوية (`ws.horizontal_page_breaks`)
`VerticalPageBreakCollection`	إفصاح الصفحة	كسر الصفحة الرأسية اليدوية (`ws.vertical_page_breaks`)
`AgileEncryptionParameters`	التشفير	معايير تشفير AES-256/SHA-512 (موصى بها)
`StandardEncryptionParameters`	التشفير	معايير التشفير AES-128/SHA-1 القديمة
`CipherAlgorithm`	التشفير	إينوم: AES_128، AEs_192،Aes_256
`HashAlgorithm`	التشفير	إينوم: SHA1، Sha256،SHA384، و Shaa512

دفتر العمل

المصممين

التوقيع	وصف
`Workbook()`	إنشاء دفتر عمل فارغ جديد (بنسخة XLSX)
`Workbook(file_path: str)`	تحميل دفتر العمل من مسار ملف
`Workbook(file_path: str, password: str)`	تحميل دفتر عمل محمي بكلمة المرور

خصائص رئيسية

الممتلكات	النوع	وصف
`worksheets`	قائمة	ورق عمل الوصول حسب المؤشر: `workbook.worksheets[0]`

الطرق الرئيسية

طريقة	العودة	وصف
`save(file_path)`	لا شيء	حفظ إلى ملف؛ تنسيق استنتاج من التوسع
`save(file_path, save_format)`	لا شيء	حفظ مع SaveFormat واضحة
`save_as_csv(file_path, options=None)`	لا شيء	حفظ كـ CSV
`save_as_markdown(file_path, options=None)`	لا شيء	حفظ كجدول تغيير المعلومات
`save_as_json(file_path, options=None)`	لا شيء	حفظ كـ JSON
`load_csv(file_path, options=None)`	لا شيء	ملء دفتر العمل من ملف CSV
`add_worksheet(name=None)`	ورقة عمل	إضافة ورقة عمل جديدة
`get_worksheet(index_or_name)`	ورقة عمل	الحصول على ورقة عمل حسب المؤشر أو الاسم
`remove_worksheet(index_or_name)`	لا شيء	إزالة ورقة عمل
`copy_worksheet(index_or_name_or_ws)`	ورقة عمل	نسخ ورقة عمل موجودة
`protect(password=None, lock_structure=True)`	لا شيء	حماية الكتب بالكلمة السرية
`unprotect(password=None)`	لا شيء	إزالة حماية دفتر العمل
`is_protected()`	بول	تحقق من أن دفتر العمل محمي

ورقة عمل

خصائص رئيسية

الممتلكات	النوع	وصف
`name`	ثاني	اسم علامة التبويب في ورقة العمل
`cells`	الخلايا	كل الخلايا في ورقة العمل هذه
`charts`	ChartCollection	كل الرسوم البيانية في ورقة العمل هذه

الخلايا

Cells يدعم الوصول على شكل قاموس عن طريق سلسلة العناوين الخلوية.

أنماط الوصول

# Read a cell value
value = ws.cells["A1"].value

# Set a cell value directly
ws.cells["A1"].value = "Hello"

# Assign a Cell object
from aspose.cells_foss import Cell
ws.cells["A1"] = Cell(42)
ws.cells["A2"] = Cell(3.14)
ws.cells["A3"] = Cell("Hello World")
ws.cells["A4"] = Cell(None, "=SUM(A1:A3)")   # formula cell

الخلية

البناة

التوقيع	وصف
`Cell(value=None)`	إنشاء خلية مع قيمة (int، float، str أو None)
`Cell(value, formula)`	إنشاء خلية صيغة (قيمة عادة هي None)

خصائص رئيسية

الممتلكات	النوع	وصف
`value`	أيّة	قيمة الخلية (str، int، float أو None)
`formula`	ثاني	سلسلة الصيغ (مثل،., `"=SUM(A1:A5)"`)
`style`	النمط	نمط الخلية (النص، ملء)

النمط

الممتلكات	النوع	وصف
`font`	الخط	إعدادات الخط لهذا النمط
`fill`	ملء	إعدادات ملء الخلفية

الخط

الألوان تعبر عن: 8-digit AARRGGBB hex strings بدون a # مُقدّم. أمثلة: "FFFF0000" = أحمر غامض،, "FF0000FF" = زرقاء غامض،, "FF000000" = أسود.

الممتلكات	النوع	التخفيضات المقصودة	وصف
`name`	ثاني	كاليبري	اسم عائلة الخطوط
`size`	الطائرة العائمة	11	حجم الخط بالنقاط
`color`	ثاني	FF000000	8-digit AARRGGBB hex color string
`bold`	بول	كاذب	نص جليد
`italic`	بول	كاذب	نص متأرجح
`underline`	بول	كاذب	نص ملخص
`strikethrough`	بول	كاذب	التشغيل عبر النص

البناة

Font(name="Calibri", size=11, color="FF000000",
     bold=False, italic=False, underline=False, strikethrough=False)

ملء

طريقة	وصف
`set_solid_fill(color)`	خلفية قوية.; `color` هو 8 أرقام AARRGGBB السلاسل الستة الأرقامات
`set_pattern_fill(pattern_type, fg_color, bg_color)`	ملء نمطي
`set_no_fill()`	إزالة ملء الخلفية

MarkdownHandler

طريقة	العودة	وصف
`MarkdownHandler.save_markdown_to_string(workbook)`	ثاني	تصدير دفتر العمل إلى سلسلة Markdown في الذاكرة

MarkdownSaveOptions

الممتلكات	النوع	التخفيضات المقصودة	وصف
`default_alignment`	ثاني	يسار	ترتيب العمود: اليسار، اليمين أو المركز
`include_worksheet_name`	بول	صحيحة	ما إذا كان يجب تضمين اسم الصفحة كعنوان.
`header_level`	int	2	مستوى التسجيل (1-6)
`worksheet_index`	int	0	مؤشر الصفحة للتصدير؛ -1 تصدير جميع الصفات

ChartCollection

يتم إضافة الرسوم البيانية باستخدام أساليب مخصصة لكل نوع. المراجع الصفوف والعمود هي على أساس الصفر.

طريقة	العودة	وصف
`add_bar(top_row, left_col, bottom_row, right_col)`	الرسم البياني	إضافة مخطط عمود (الشرطة العمودي)
`add_line(top_row, left_col, bottom_row, right_col)`	الرسم البياني	إضافة مخطط سطري
`add_pie(top_row, left_col, bottom_row, right_col)`	الرسم البياني	إضافة مخطط الفطيرة

الرسم البياني

الممتلكات	النوع	وصف
`title`	ثاني	عنوان الرسم البياني كسلسله بسيطه (ليس `.title.text`)
`category_data`	ثاني	نطاق الخلايا لملصقات فئة محور x
`n_series`	سلسلة NS	جمع سلسلة البيانات
`show_legend`	بول	ما إذا كان عرض الأسطورة
`legend_position`	ثاني	موقع الأسطورة: اليمين، أسفل، اليسار أو أعلى.

سلسلة NS

طريقة	وصف
`add(data_range, category_data=None, name=None)`	إضافة سلسلة بيانات مسمّية

SaveFormat الإحصاء

ثابتة	شكل الناتج
`SaveFormat.XLSX`	شكل Excel XML (الجهل)
`SaveFormat.CSV`	القيم المفصلة عن النقطة
`SaveFormat.TSV`	ثابت القراءة فقط. `workbook.save()` لا تدعم زيادة لـ TSV. `ValueError` في وقت التشغيل.
`SaveFormat.MARKDOWN`	جداول التخفيضات
`SaveFormat.JSON`	بيانات JSON المنظمة

ملاحظة:: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX,، و SaveFormat.PPTX هي غير متوفرة في Aspose.Cells FOSS. هذه الصيغ تتطلب إصدارات التجارة aspose-cells-python حزمة.

أمثلة رمزية

إنشاء وكيفية، وحفظ دفتر العمل

from aspose.cells_foss import Workbook, Cell

wb = Workbook()
ws = wb.worksheets[0]

ws.cells["A1"].value = "Revenue Report"
ws.cells["A2"].value = 125000

ws.cells["A1"].style.font.bold = True
ws.cells["A1"].style.font.size = 14
ws.cells["A1"].style.font.color = "FF1E64C8"   # Blue (AARRGGBB, no #)

wb.save("report.xlsx")

التصدير إلى Markdown في الذاكرة

from aspose.cells_foss import Workbook, Cell, MarkdownHandler

wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95

md = MarkdownHandler.save_markdown_to_string(wb)
print(md)

قم بإنشاء مخطط خطي

from aspose.cells_foss import Workbook, Cell

wb = Workbook()
ws = wb.worksheets[0]

for i, (m, v) in enumerate([("Jan", 50), ("Feb", 80), ("Mar", 120)], start=2):
    ws.cells[f"A{i}"].value = m
    ws.cells[f"B{i}"].value = v

chart = ws.charts.add_line(5, 0, 18, 7)
chart.title = "Monthly Trend"
chart.category_data = "A2:A4"
chart.n_series.add("B2:B4", category_data="A2:A4", name="Sales")

wb.save("trend.xlsx")

الموارد ذات الصلة

دليل المطورين: دروس لجميع الميزات الأساسية
البدء / التثبيت: pip تنصيب وتجهيز
قاعدة المعرفة: أدلة التوجيه المكلفة بالمهام
نظرة عامة على المنتج: ملخص الميزات والقدرات
GitHub مستودع
مدونة: تقديم Aspose.Cells FOSS: لمحة عامة عن المكتبة وبدء سريع