راهنمای توسعهدهنده
این راهنما قابلیتهای اصلی Aspose.Slides FOSS برای C++ را با مثالهای کد قابل کامپایل برای هر حوزه ویژگی پوشش میدهد.
در این بخش
| صفحه | توضیح |
|---|---|
| ویژگیها و قابلیتها | فهرست کامل ویژگیهای پشتیبانیشده: slides, shapes, text, fill, effects, 3D formatting, notes, comments, images, و document properties. |
| کار با تصاویر | تصاویر را بهعنوان فریمهای تصویری در slides از فایل یا بردار بایت جاسازی کنید؛ حالت fill (stretch, tile) را کنترل کنید. |
| کار با Connectors | اتصالات خمیده، آرمی و مستقیم را بین اشکال اضافه کنید؛ نقاط اتصال و سبک خط را تنظیم کنید. |
| کار با افکتهای سهبعدی | سایه بیرونی، درخشندگی، تاری، برجستگی، پیشتنظیمهای دوربین، ستهای نور و مواد را بر روی اشکال اعمال کنید. |
| کار با نظرات | نظرات بررسی سلسلهوار و یادداشتهای سخنران را اضافه کنید؛ نویسندگان نظرات را مدیریت کنید؛ حاشیهنویسیها را بخوانید. |
نقطه ورود 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 یا فرمتهای تصویری در این نسخه موجود نیست.
کلاسهای کلیدی
| کلاس / شمارش | سرصفحه | توضیح |
|---|---|---|
Presentation | presentation.h | محفظه ریشه؛ از RAII برای مدیریت منابع استفاده میکند |
ShapeType | shape_type.h | Enum برای انواع شکل (RECTANGLE, ELLIPSE, …) |
FillType | fill_type.h | Enum برای انواع پرکردن (SOLID, GRADIENT, …) |
NullableBool | nullable_bool.h | بولی سهحالت برای قالببندی (TRUE, FALSE, NOT_DEFINED) |
SaveFormat | export/save_format.h | Enum فرمت خروجی (فقط PPTX پشتیبانی میشود) |
Color | drawing/color.h | سازنده رنگ ARGB |
PointF | drawing/point_f.h | نقطه Float دو بعدی (برای موقعیتهای نظرات استفاده میشود) |
تمام هدرها زیر هستند Aspose/Slides/Foss/. فضاینام است Aspose::Slides::Foss. انواع رسم از Aspose::Slides::Foss::Drawing.
محدودیتهای شناختهشده
مناطق زیر در این نسخه موجود نیستند:
- نمودارها: ایجاد یا تغییر نمودار وجود ندارد
- SmartArt: پشتیبانی نمیشود
- انیمیشنها و انتقالها: انتقال اسلایدها و انیمیشنهای اشیاء قابل تنظیم نیست
- قالبهای خروجی: فقط ذخیره بهصورت PPTX پشتیبانی میشود؛ خروجی PDF، HTML، SVG یا تصویر وجود ندارد
- هایپرلینکها و تنظیمات اقدام: اشیاء پیوندی قابل ویرایش نیستند
- ماکروهای VBA و امضاهای دیجیتال:قابل دسترسی نیست
بخشهای XML ناشناسی که در هنگام بارگذاری مواجه میشوند، بهصورت دقیق در زمان ذخیرهسازی حفظ میشوند، بنابراین در فرآیند دورانی هرگز محتوایی که کتابخانه هنوز درک نمیکند حذف نمیشود.
همچنین ببینید
- شروع به کار: نصب و اولین برنامه
- مرجع API: مرجع کلاس و متد
- راهنماهای گامبهگام: مقالات نحوه انجام مبتنی بر کار
