دليل المطور

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

في هذا القسم

PageDescription
الميزات والقدراتالقائمة الكاملة للميزات المدعومة: الشرائح، الأشكال، النص، التعبئة، التأثيرات، تنسيق ثلاثي الأبعاد، الملاحظات، التعليقات، الصور، وخصائص المستند.
العمل مع الصورإدراج الصور في الشرائح كإطارات صور من ملف أو متجه بايت؛ التحكم في وضع التعبئة (تمدد، تجانب).
العمل مع الموصلاتإضافة موصلات منحنية، كوعية ومستقيمة بين الأشكال؛ تعيين مواقع الاتصال ونمط الخط.
العمل مع التأثيرات ثلاثية الأبعادتطبيق الظل الخارجي، التوهج، الضبابية، الحافة، إعدادات الكاميرا المسبقة، إضاءة المشهد، والمواد على الأشكال.
العمل مع التعليقاتإضافة تعليقات مراجعة متسلسلة وملاحظات المتحدث؛ إدارة مؤلفي التعليقات؛ قراءة التعليقات التوضيحية.

نقطة دخول API

يبدأ كل عملية بكائن Presentation. يستخدم RAII لتنظيف الموارد تلقائيًا:

#include <Aspose/Slides/Foss/presentation.h>
#include <Aspose/Slides/Foss/export/save_format.h>

using namespace Aspose::Slides::Foss;

// Open existing
{
    Presentation pres("input.pptx");
    // work with pres
    pres.save("output.pptx", SaveFormat::PPTX);
}

// Create new
{
    Presentation pres;
    // work with pres
    pres.save("new.pptx", SaveFormat::PPTX);
}

عند خروج كائن Presentation من النطاق، يتم تحرير موارد XML/OPC الداخلية. يمكنك أيضًا استدعاء pres.dispose() صراحةً؛ استدعاؤه عدة مرات آمن.

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

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

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

Class / EnumHeaderDescription
Presentationpresentation.hحاوية جذر؛ تستخدم RAII لإدارة الموارد
ShapeTypeshape_type.hتعداد لأنواع الأشكال (RECTANGLE, ELLIPSE, …)
FillTypefill_type.hتعداد لأنواع التعبئة (SOLID, GRADIENT, …)
NullableBoolnullable_bool.hقيمة منطقية ثلاثية الحالات للتنسيق (TRUE, FALSE, NOT_DEFINED)
SaveFormatexport/save_format.hتعداد صيغ الإخراج (يدعم فقط PPTX)
Colordrawing/color.hمنشئ لون ARGB
PointFdrawing/point_f.hنقطة عائمة ثنائية الأبعاد (تُستخدم لمواقع التعليقات)

جميع رؤوس الأعمدة تحت Aspose/Slides/Foss/. مساحة الاسم هي Aspose::Slides::Foss. تستخدم أنواع الرسم Aspose::Slides::Foss::Drawing.

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

المناطق التالية غير متوفرة في هذا الإصدار:

  • Charts: لا يمكن إنشاء المخططات أو تعديلها
  • SmartArt: غير مدعوم
  • Animations and transitions: لا يمكن تعيين انتقالات الشرائح أو رسوم المتحركة للكائنات
  • Export formats: يدعم حفظ PPTX فقط؛ لا تصدير إلى PDF أو HTML أو SVG أو صورة
  • Hyperlinks and action settings: لا يمكن تعديل كائنات الروابط
  • VBA macros and digital signatures: غير متاح

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

انظر أيضًا

 العربية