راهنمای توسعهدهنده
این راهنما قابلیتهای اصلی Aspose.Slides FOSS برای Java را با مثالهای کد قابل اجرا برای هر حوزه ویژگی پوشش میدهد.
در این بخش
| صفحه | توضیح |
|---|---|
| ویژگیها و قابلیتها | فهرست کامل ویژگیهای پشتیبانیشده: اسلایدها، اشکال، متن، پر کردن، افکتها، قالببندی 3D، یادداشتها، نظرات، تصاویر و ویژگیهای سند. |
| کار با تصاویر | تصاویر را بهعنوان فریمهای تصویری از فایل یا بایتها در اسلایدها جاسازی کنید؛ حالت پر کردن (کشیده شدن، کاشی) را کنترل کنید. |
| کار با کانکتورها | کانکتورهای خمیده، زانو دار و مستقیم را بین اشکال اضافه کنید؛ نقاط اتصال و سبک خط را تنظیم کنید. |
| کار با افکتهای 3D | سایه خارجی، درخشندگی، تاری، برجستگی، پیشتنظیمات دوربین، نورپردازیها و مواد را به اشکال اعمال کنید. |
| کار با نظرات | نظرات بررسی سلسلهوار و یادداشتهای سخنران را اضافه کنید؛ نویسندگان نظرات را مدیریت کنید؛ حاشیهنویسیها را بخوانید. |
نقطه ورود 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 یا فرمتهای تصویری در این نسخه موجود نیست.
کلاسهای کلیدی
| کلاس / شمارش | بسته | توضیح |
|---|---|---|
Presentation | org.aspose.slides.foss | محفظه ریشه؛ در try-with-resources استفاده کنید |
ShapeType | org.aspose.slides.foss | Enum برای انواع شکل (RECTANGLE, ELLIPSE, …) |
FillType | org.aspose.slides.foss | Enum برای انواع پر کردن (SOLID, GRADIENT, …) |
NullableBool | org.aspose.slides.foss | bool سهحالی برای قالببندی (TRUE, FALSE, NOT_DEFINED) |
SaveFormat | org.aspose.slides.foss.export | enum فرمت خروجی (فقط PPTX پشتیبانی میشود) |
Color | org.aspose.slides.foss.drawing | سازنده رنگ ARGB |
PointF | org.aspose.slides.foss.drawing | نقطه دوبعدی Float (برای موقعیتهای نظرات استفاده میشود) |
محدودیتهای شناختهشده
مناطق زیر ایجاد میشوند UnsupportedOperationException در این نسخه:
- نمودارها: ایجاد یا تغییر نمودارها امکانپذیر نیست
- SmartArt: پشتیبانی نمیشود
- انیمیشنها و انتقالها: انتقال اسلایدها و انیمیشنهای اشیاء قابل تنظیم نیستند
- فرمتهای خروجی: فقط ذخیره به صورت PPTX پشتیبانی میشود؛ خروجی PDF، HTML، SVG یا تصویر وجود ندارد
- پیوندهای فراگیر و تنظیمات عمل: اشیاء پیوندی قابل ویرایش نیستند
- ماکروهای VBA و امضاهای دیجیتال:قابل دسترسی نیست
بخشهای XML ناشناسی که در هنگام بارگذاری مواجه میشوند، بهصورت دقیق در زمان ذخیره حفظ میشوند، بنابراین دورگرد (round‑tripping) هرگز محتوایی را که کتابخانه هنوز نمیفهمد حذف نمیکند.
همچنین ببینید
- شروع به کار: نصب و اولین برنامه
- مرجع API: مرجع کلاس و متد
- راهنماهای گامبهگام: مقالات نحوه انجام مبتنی بر وظیفه
