دليل المطور

يغطي هذا الدليل القدرات الأساسية لـ Aspose.Slides FOSS لـ Python مع أمثلة شفرة قابلة للتنفيذ لكل مجال من المجالات.

في هذا القسم

صفحةالوصف
الميزات والقدراتالقائمة الكاملة للميزات المدعومة: slides, shapes, text, fill, effects, 3D formatting, notes, comments, images, و document properties.
العمل مع الصورإدراج الصور في slides كإطارات صور من ملف أو بايتات؛ التحكم في وضع fill mode (stretch, tile).
العمل مع Connectorsإضافة موصلات bent، elbow، وstraight بين shapes؛ ضبط connection sites ونمط الخط (line style).
العمل مع 3D Effectsتطبيق outer shadow، glow، blur، bevel، camera presets، light rigs، وmaterials على shapes.
العمل مع التعليقاتإضافة تعليقات مراجعة متسلسلة وملاحظات المتحدث؛ إدارة مؤلفي التعليقات؛ قراءة الملاحظات التوضيحية.

نقطة دخول API

كل عملية تبدأ بـ Presentation كائن. استخدمه دائمًا كمدير سياق:

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

# Open existing
with slides.Presentation("input.pptx") as prs:
    # work with prs
    prs.save("output.pptx", SaveFormat.PPTX)

# Create new
with slides.Presentation() as prs:
    # work with prs
    prs.save("new.pptx", SaveFormat.PPTX)

يضمن مدير السياق تحرير الموارد الداخلية COM/XML عند خروج الكتلة. لا تقم بتخزين Presentation مرجع خارج الـ with الكتلة.

تنسيقات الإخراج المدعومة

الصيغة الوحيدة المدعومة للحفظ هي PPTX (SaveFormat.PPTX). التصدير إلى PDF أو HTML أو SVG أو صيغ الصور غير متوفر في هذا الإصدار.

الفئات الرئيسية

فئة / تعدادمسار الاستيرادالوصف
Presentationaspose.slides_fossحاوية الجذر؛ استخدمها كمدير سياق
ShapeTypeaspose.slides_fossتعداد لأنواع الأشكال (RECTANGLE, ELLIPSE, …)
FillTypeaspose.slides_fossتعداد لأنواع التعبئة (SOLID, GRADIENT, …)
NullableBoolaspose.slides_fossقيمة منطقية ثلاثية الحالة للتنسيق (TRUE, FALSE, NOT_DEFINED)
SaveFormataspose.slides_foss.exportتعداد تنسيق الإخراج (يدعم فقط PPTX)
Coloraspose.slides_foss.drawingمنشئ لون ARGB
PointFaspose.slides_foss.drawingنقطة عائمة ثنائية الأبعاد (تُستخدم لمواقع التعليقات)

القيود المعروفة

المناطق التالية تُثير NotImplementedError في هذا الإصدار:

  • المخططات: لا يمكن إنشاء مخططات أو تعديلها
  • SmartArt: غير مدعوم
  • الرسوم المتحركة والانتقالات: لا يمكن ضبط انتقالات الشرائح والرسوم المتحركة للكائنات
  • تنسيقات التصدير: يدعم حفظ PPTX فقط؛ لا تصدير PDF أو HTML أو SVG أو صور
  • الروابط التشعبية وإعدادات الإجراءات: كائنات الروابط غير قابلة للتعديل
  • ماكرو VBA والتوقيعات الرقمية: غير متاح

الأجزاء غير المعروفة من XML التي تم مواجهتها أثناء التحميل تُحفظ حرفيًا عند الحفظ، لذا فإن عملية round-tripping لا تزيل أبدًا المحتوى الذي لا تفهمه المكتبة بعد.

هذا أيضا

 العربية