دليل المطور

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

في هذا القسم

صفحةالوصف
الميزات والقدراتالقائمة الكاملة للميزات المدعومة: slides, shapes, text, fill, effects, 3D formatting, notes, comments, images, and document properties.
العمل مع الصورإدراج الصور في slides كإطارات صور من ملف أو بايتات؛ التحكم في fill mode (stretch, tile).
العمل مع الموصلاتإضافة موصلات منحنية، كوعية، ومستقيمة بين shapes؛ ضبط مواقع الاتصال ونمط الخط.
العمل مع تأثيرات 3Dتطبيق الظل الخارجي، التوهج، الضبابية، الحافة، إعدادات الكاميرا المسبقة، تركيبات الإضاءة، والمواد على shapes.
العمل مع التعليقاتإضافة تعليقات مراجعة متسلسلة وملاحظات المتحدث؛ إدارة مؤلفي التعليقات؛ قراءة الشروح.

نقطة دخول API

كل عملية تبدأ بـ Presentation كائن. يجب دائمًا استخدامه داخل كتلة try-with-resources:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.export.SaveFormat;

// Open existing
try (Presentation prs = new Presentation("input.pptx")) {
    // work with prs
    prs.save("output.pptx", SaveFormat.PPTX);
}

// Create new
try (Presentation prs = new Presentation()) {
    // work with prs
    prs.save("new.pptx", SaveFormat.PPTX);
}

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

صيغة الإخراج المدعومة

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

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

فئة / تعدادحزمةالوصف
Presentationorg.aspose.slides.fossحاوية الجذر؛ استخدمها في try-with-resources
ShapeTypeorg.aspose.slides.fossتعداد لأنواع الأشكال (RECTANGLE, ELLIPSE, …)
FillTypeorg.aspose.slides.fossتعداد لأنواع التعبئة (SOLID, GRADIENT, …)
NullableBoolorg.aspose.slides.fossقيمة منطقية ثلاثية الحالات للتنسيق (TRUE, FALSE, NOT_DEFINED)
SaveFormatorg.aspose.slides.foss.exportتعداد تنسيق الإخراج (PPTX فقط مدعوم)
Colororg.aspose.slides.foss.drawingمنشئ لون ARGB
PointForg.aspose.slides.foss.drawingنقطة Float ثنائية الأبعاد (تُستخدم لمواقع التعليقات)

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

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

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

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

انظر أيضًا

 العربية