1. المنتجات
  2.   Aspose.Slides
  3.   Aspose.Slides FOSS for .NET

Aspose.Slides FOSS لـ .NET

إنشاء وقراءة وتحرير عروض PowerPoint من .NET — مجانية ومفتوحة المصدر، لا تحتاج إلى اعتماد على Office.

مكتبة .NET مفتوحة المصدر لعروض PowerPoint

Aspose.Slides FOSS for .NET هي مكتبة pure-C# مرخصة MIT للعمل مع ملفات PowerPoint .pptx. أضف حزمة NuGet واحدة وابدأ فورًا في إنشاء وقراءة وتحرير العروض التقديمية دون تثبيت Microsoft Office أو أي بيئة تشغيل مملوكة.

تُظهر المكتبة واجهة برمجة تطبيقات Presentation مبنية حول Presentation, Slide, Shape, TextFrame, Paragraph, وPortion, النموذج المفاهيمي الذي يستخدمه PowerPoint نفسه. أضف وأزل الشرائح, أدخل AutoShapes, Tables, وConnectors, نسق النص على مستوى الحرف باستخدام الغامق, المائل, حجم الخط واللون, طبّق تعبئات صلبة أو متدرجة, وأضف تأثيرات بصرية (shadow, glow, blur, reflection).

نمط IDisposable يضمن تنظيف الموارد بشكل موثوق: دائمًا قم بلف Presentation داخل بيان using. الأجزاء غير المعروفة من XML التي يتم مواجهتها أثناء التحميل تُحفظ حرفيًا عند الحفظ، لذا فإن عملية النقل المتكرر لا تدمر المحتوى الذي لا تفهمه المكتبة بعد. المكتبة تتطلب .NET 9.0 أو أحدث ولا تحتوي على امتدادات أصلية للترجمة. يمكن للمطورين الذين يحتاجون إلى واجهة برمجة تطبيقات المؤسسة الكاملة مع دعم إنتاج كامل استخدام Aspose.Slides for .NET إلى جانب هذه الموارد المفتوحة المصدر.

واجهة برمجة تطبيقات العروض والشرائح

  • إنشاء وفتح PPTX: إنشاء عروض تقديمية جديدة أو فتح ملفات .pptx الموجودة عبر new Presentation() أو new Presentation(file).
  • إضافة وإزالة الشرائح: إدارة SlideCollection برمجيًا باستخدام AddClone()، AddEmptySlide()، Remove()، وRemoveAt().
  • AutoShapes: إدراج المستطيلات، والدوائر البيضاوية، والخطوط، وغيرها من ShapeType الهندسية عبر AddAutoShape().
  • الجداول والموصلات: أضف أشكال جداول منظمة وخطوط موصل بين الأشكال عبر AddConnector().
  • ملاحظات المتحدث: قراءة وكتابة ملاحظات المتحدث لكل شريحة عبر NotesSlideManager
  • التعليقات المتسلسلة: الوصول إلى سلاسل التعليقات على مستوى الشريحة باستخدام GetSlideComments().

أين يمكن استخدام Aspose.Slides FOSS

  • إنشاء التقارير: بناء مجموعات شرائح ذات علامة تجارية من مصادر البيانات دون Office.
  • أتمتة القوالب: ملء قوالب PPTX بالمحتوى الديناميكي في خطوط أنابيب CI/CD.
  • ترحيل المحتوى: قراءة العروض التقديمية الحالية وإعادة هيكلة الشرائح أو إعادة تنسيقها.
  • الخدمات الخلفية بدون خادم: معالجة ملفات PPTX داخل حاويات Docker أو Azure Functions.
  • Batch processing: تطبيق تغييرات تنسيق موحدة عبر مكتبات شرائح العرض الكبيرة.

تنسيق النص والتأثيرات البصرية

  • تنسيق على مستوى الأحرف: تطبيق الخط العريض، المائل، حجم الخط، واللون على كائنات Portion الفردية عبر PortionFormat.
  • ملء صلب وتدرج لوني: اضبط ملء الشكل إلى لون صلب أو تدرج خطي متعدد النقاط باستخدام FillFormat و FillType.
  • تأثيرات الظل والوهج: طبّق الظل الخارجي، والوهج، والطمس، والانعكاس على أي شكل عبر EffectFormat.
  • محاذاة الفقرة: اضبط المحاذاة إلى اليسار أو الوسط أو اليمين أو ضبط النص بالكامل لكل فقرة باستخدام ParagraphFormat.Alignment.
  • آمن للرحلة ذهابًا وإيابًا: يتم حفظ أجزاء XML غير المعروفة حرفيًا عند إعادة الحفظ.

تجربة المطور

يتم تثبيت Aspose.Slides FOSS بأمر dotnet add package Aspose.Slides.Foss واحد. المكتبة هي C# صافية دون أي امتدادات أصلية للترجمة ولا حزم نظام لتثبيتها.

تعكس واجهة برمجة التطبيقات نموذج الكائنات الخاص بـ PowerPoint (Presentation, Slide, Shape, TextFrame, Paragraph, Portion)، لذا يمكن لأي شخص مألوف بنموذج كائنات PowerPoint استخدام المكتبة فورًا. إنها مرخصة بموجب MIT، مفتوحة المصدر على GitHub، وتتطلب .NET 9.0 أو أحدث.

إنشاء عرض تقديمي وإضافة شكل

استخدم عبارة using لضمان أن Presentation يتم التخلص منها دائمًا وتحرير الموارد. AddAutoShape() يأخذ تعداد ShapeType، ثم موضع x/y والعرض/الارتفاع بالنقاط. استدعِ AddTextFrame() لإنشاء إطار النص وتعيين النص الأولي في استدعاء واحد — لا تقم بالوصول إلى TextFrame قبل استدعاء AddTextFrame() لأن الإطار يكون فارغًا (null) حتى يتم إنشاؤه.

dotnet add package Aspose.Slides.Foss
using Aspose.Slides.Foss;

using var prs = new Presentation();
var slide = prs.Slides[0];

// Add a rectangle AutoShape
var shape = slide.Shapes.AddAutoShape(
    ShapeType.Rectangle, 50, 50, 400, 150
);
shape.AddTextFrame("Hello, Aspose.Slides!");

prs.Save("output.pptx", SaveFormat.Pptx);

تنسيق النص وتطبيق تأثير تعبئة

تنسيق النص يعمل على مستوى Portion — أصغر وحدة من سلسلة الأحرف. افتح الملف المحفوظ، وانتقل إلى الجزء الأول من الفقرة الأولى، وقم بتعيين خصائص الخط مباشرة. تعبئة الشكل مستقلة: اضبط FillType إلى Solid وعيّن لونًا لـ SolidFillColor.Color.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;

using var prs = new Presentation("output.pptx");
var shape = (IAutoShape)prs.Slides[0].Shapes[0];
var portion = shape.TextFrame.Paragraphs[0].Portions[0];

// Bold, 18pt, dark-blue text
portion.PortionFormat.FontBold = NullableBool.True;
portion.PortionFormat.FontHeight = 18;
portion.PortionFormat.FillFormat.SolidFillColor.Color =
    Color.FromArgb(255, 0, 0, 139);

// Solid background fill on the shape
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.Color =
    Color.FromArgb(255, 240, 248, 255);

prs.Save("formatted.pptx", SaveFormat.Pptx);

الأسئلة الشائعة

ما هو Aspose.Slides FOSS لـ .NET؟

إنها مكتبة مجانية مرخصة بموجب MIT ونقية-C# لإنشاء وقراءة وتحرير عروض PowerPoint .pptx دون الحاجة إلى Microsoft Office.

ما هي صيغ الملفات المدعومة؟

.pptx هو تنسيق القراءة/الكتابة المدعوم. التصدير إلى PDF، HTML، SVG، أو الصور غير متوفر في هذه النسخة.

هل يتطلب Microsoft Office أو PowerPoint؟

لا. Aspose.Slides FOSS هي مكتبة pure-C# لا تعتمد على Microsoft Office أو COM automation أو أي بيئة تشغيل مملوكة.

كيف أقوم بتثبيته؟

شغّل dotnet add package Aspose.Slides.Foss. المكتبة تتطلب .NET 9.0 أو أحدث. لا توجد امتدادات أصلية للتجميع.

هل يمكنني تطبيق تأثيرات بصرية مثل الظل والتوهج؟

نعم. المكتبة تدعم تأثيرات الظل الخارجي، التوهج، الضبابية، والانعكاس على أي كائن شكل عبر واجهة برمجة التطبيقات EffectFormat.

هل يُنصح بنمط IDisposable؟

نعم. احرص دائمًا على تغليف Presentation داخل بيان using (using var prs = new Presentation();) لضمان تنظيف الموارد بشكل موثوق.

هل سيتسبب تحويل PPTX ذهابًا وإيابًا في تدمير المحتوى غير المعروف؟

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

أين يمكنني العثور على شفرة المصدر؟

المكتبة مرخصة تحت رخصة MIT ومستضافة على GitHub. تقارير الأخطاء وطلبات السحب مرحب بها.

  

الدعم وموارد التعلم

 العربية