راهنمای توسعهدهنده
این راهنما قابلیتهای اصلی Aspose.Slides FOSS برای .NET را همراه با مثالهای کد قابل اجرا برای هر حوزه ویژگی پوشش میدهد.
در این بخش
| صفحه | توضیح |
|---|---|
| ویژگیها و قابلیتها | فهرست کامل ویژگیهای پشتیبانیشده: اسلایدها، اشکال، متن، پر کردن، افکتها، قالببندی سهبعدی، یادداشتها، نظرات، تصاویر و ویژگیهای سند. |
| کار با تصاویر | تصاویر را بهعنوان فریمهای تصویری از فایل یا جریان در اسلایدها جاسازی کنید؛ حالت پر کردن (کشیده شدن، کاشی) را کنترل کنید. |
| کار با کانکتورها | کانکتورهای خمیده، آرنجی و مستقیم را بین اشکال اضافه کنید؛ نقاط اتصال و سبک خط را تنظیم کنید. |
| کار با افکتهای سهبعدی | سایه خارجی، درخشندگی، تاری، برجستگی، پیشتنظیمات دوربین، نورپردازیها و مواد را بر روی اشکال اعمال کنید. |
| کار با نظرات | نظرات بررسی رشتهای و یادداشتهای گوینده را اضافه کنید؛ نویسندگان نظرات را مدیریت کنید؛ حاشیهنویسیها را بخوانید. |
نقطه ورودی API
هر عملیات با یک شیء Presentation شروع میشود. همیشه آن را با یک عبارت using استفاده کنید:
using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;
// Open existing
using var prs = new Presentation("input.pptx");
// work with prs
prs.Save("output.pptx", SaveFormat.Pptx);using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;
// Create new
using var prs = new Presentation();
// work with prs
prs.Save("new.pptx", SaveFormat.Pptx);دستور using تضمین میکند که منابع داخلی هنگام خروج از محدوده آزاد شوند. یک مرجع Presentation را فراتر از محدوده using آن ذخیره نکنید.
قالب خروجی پشتیبانیشده
تنها قالب ذخیرهسازی پشتیبانیشده PPTX (SaveFormat.Pptx) است. خروجی به PDF، HTML، SVG یا فرمتهای تصویری در این نسخه موجود نیست.
کلاسهای کلیدی
| کلاس / شمارش | فضاینام | توضیح |
|---|---|---|
Presentation | Aspose.Slides.Foss | محفظه ریشه؛ پیادهسازی IDisposable |
ShapeType | Aspose.Slides.Foss | شمارش برای انواع شکل (مستطیل، بیضی، …) |
FillType | Aspose.Slides.Foss | شمارش برای انواع پرکن (یکدانه، گرادیان، …) |
NullableBool | Aspose.Slides.Foss | بولی سهحالت برای قالببندی (True, False, NotDefined) |
SaveFormat | Aspose.Slides.Foss.Export | شمارش فرمت خروجی (فقط Pptx پشتیبانی میشود) |
PointF | 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 که در هنگام بارگذاری مواجه میشوند، بهصورت دقیق حفظ میشوند و در زمان ذخیرهسازی، همانگونه باقی میمانند؛ بنابراین دور زدن (round‑tripping) هرگز محتوایی را که کتابخانه هنوز درک نمیکند حذف نمیکند.
همچنین ببینید
- شروع کار: نصب و اولین برنامه
- مرجع API: مرجع کلاس و متد
- راهنماهای گامبهگام: مقالات گامبهگام مبتنی بر وظیفه
