فایل های ارائه در فرمت های مختلف مانند PPT، PPTX و ODP هستند. شما باید با نرم افزارهایی مانند Microsoft PowerPoint، OpenOffice Impress و Apple Keynote آشنایی داشته باشید – همه آنها با این فرمت ها کار می کنند و به ما در ایجاد ارائه های شگفت انگیز کمک می کنند. به عنوان توسعه دهندگان، ما این قدرت را داریم که به صورت برنامه نویسی این ارائه ها را در برنامه های خود ویرایش کنیم. این مقاله شما را در مورد نحوه ویرایش ارائه‌های PPT/PPTX در Java با استفاده از API ویرایش ارائه راهنمایی می‌کند.
در این مقاله به موضوعات زیر می پردازیم:
Java API برای ویرایش و اتوماسیون ارائه ها
در مثال‌هایمان، به یک کتابخانه قدرتمند GroupDocs.Editor for Java تکیه می‌کنیم. این کتابخانه به عنوان یک API ویرایش ارائه عمل می کند و به توسعه دهندگان این امکان را می دهد تا ارائه ها را به صورت یکپارچه بارگیری، ویرایش و ذخیره کنند در قالب هایی مانند PPT، PPTX و PDF.
این API نه تنها ارائه‌ها را مدیریت می‌کند، بلکه از ویرایش انواع اسناد دیگر، از جمله اسناد پردازش کلمه، صفحات گسترده، HTML، XML، JSON، TXT، TSV و فرمت‌های CSV نیز پشتیبانی می‌کند.
برای شروع، می‌توانید فایل JAR لازم را از بخش دانلودها دانلود کنید یا آخرین مخزن و پیکربندی‌های وابستگی Maven را مستقیماً در برنامه‌های Java خود بگنجانید.
<repository>
<id>GroupDocsJavaAPI</id>
<name>GroupDocs Java API</name>
<url>https://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-editor</artifactId>
<version>21.3</version>
</dependency>
ویرایش ارائه های PPT/PPTX در Java
هنگامی که API را تنظیم کردید، می توانید به سرعت ویرایش اسلایدهای ارائه خود را شروع کنید. در اینجا مراحل ویرایش ارائه ها در PPT/PPTX و سایر فرمت های سازگار آمده است:
مرحله 1: ارائه را بارگیری کنید
با بارگیری ارائه شروع کنید. اگر ارائه با رمز عبور محافظت می شود، مسیر فایل و رمز عبور را ارائه دهید.
// Load Presentation
PresentationLoadOptions loadOptions = new PresentationLoadOptions();
loadOptions.setPassword("P@$$w0Rd");
Editor editor = new Editor(new FileInputStream("path/presentation.pptx"), loadOptions);
مرحله 2: اسلایدهای ارائه PPT/PPTX را با Java ویرایش کنید
پس از بارگذاری، ارائه را در صورت نیاز اصلاح کنید. به عنوان مثال، در کد Java زیر، من تکرار کلمه “documents” را با “presentation” در یک ارائه PPTX جایگزین می کنم.
// Edit Presentation
Editor editor = new Editor(new FileInputStream("path/presentation.pptx"), loadOptions);
PresentationEditOptions editOptions = new PresentationEditOptions();
editOptions.setSlideNumber(0); //1st slide
editOptions.setShowHiddenSlides(true);
EditableDocument beforeEdit = editor.edit(editOptions);
String originalContent = beforeEdit.getContent();
List<IHtmlResource> allResources = beforeEdit.getAllResources();
String editedContent = originalContent.replace("document", "presentation");
مرحله 3: ارائه پاورپوینت ویرایش شده را با گزینه ها ذخیره کنید
هنگام ذخیره محتوای ویرایش شده، انعطاف پذیری برای تنظیم گزینه های مختلف دارید. این گزینه ها شامل تنظیم رمز عبور و پیکربندی تنظیمات فرمت خروجی است. در قطعه کد زیر، نحوه اعمال این گزینه ها و ذخیره ارائه ویرایش شده را به عنوان یک فایل PPTX محافظت شده با رمز عبور نشان می دهم.
// Save Presentation
EditableDocument afterEdit = EditableDocument.fromMarkup(editedContent, allResources);
PresentationSaveOptions saveOptions = new PresentationSaveOptions(PresentationFormats.Pptm);
saveOptions.setPassword("new_pa$$word");
editor.save(afterEdit, new ByteArrayOutputStream(), saveOptions);
try(OutputStream outputFile = new FileOutputStream("path/edited-presentation.pptx")) {
outputStream.writeTo(outputFile);
}
نمونه کد کامل جاوا
برای راحتی شما، در اینجا کد کامل Java که در بالا توضیح داده شد، آمده است. این کد نحوه ویرایش یک ارائه پاورپوینت و ذخیره آن در قالب PPTX را نشان می دهد.
// ویرایش PPT/PPTX ارائه در Java با استفاده از ویرایش و اتوماسیون ارائه GroupDocs API
// بارگذاری ارائه
PresentationLoadOptions loadOptions = new PresentationLoadOptions();
loadOptions.setPassword("P@$$w0Rd");
// ویرایش ارائه
Editor editor = new Editor(new FileInputStream("path/presentation.pptx"), loadOptions);
PresentationEditOptions editOptions = new PresentationEditOptions();
editOptions.setSlideNumber(0); //1st slide
editOptions.setShowHiddenSlides(true);
EditableDocument beforeEdit = editor.edit(editOptions);
String originalContent = beforeEdit.getContent();
List<IHtmlResource> allResources = beforeEdit.getAllResources();
String editedContent = originalContent.replace("document", "presentation");
// ذخیره ارائه
EditableDocument afterEdit = EditableDocument.fromMarkup(editedContent, allResources);
PresentationSaveOptions saveOptions = new PresentationSaveOptions(PresentationFormats.Pptm);
saveOptions.setPassword("new_pa$$word");
editor.save(afterEdit, new ByteArrayOutputStream(), saveOptions);
try(OutputStream outputFile = new FileOutputStream("path/edited-presentation.pptx")) {
outputStream.writeTo(outputFile);
}
پس از اجرای کد بالا، نمایش خروجی مانند تصویر زیر خواهد بود. در این ارائه ویرایش شده، همه موارد تکرار کلمه “اسناد” با “ارائه” جایگزین شده است.
ارائه خروجی - وقوع اسناد با ارائه جایگزین می شود
با خیال راحت کد را تست کنید و تغییرات را خودتان ببینید! اگر سؤالی دارید یا به کمک بیشتری نیاز دارید، دریغ نکنید.
نتیجه
به طور خلاصه، نحوه ویرایش اسلایدهای ارائه در Java را با استفاده از یک API ویرایش ارائه بررسی کردیم. این API به شما این امکان را می دهد که ارائه های خود را با استفاده از ویرایشگرهای WYSIWYG به صورت بصری ویرایش کنید. با این دانش، می توانید ویرایشگر ارائه خود را ایجاد کنید یا ویژگی ویرایش را مستقیماً در برنامه Java خود ادغام کنید.
برای اطلاعات عمیق، گزینه‌های اضافی و مثال‌ها، می‌توانید به اسناد و مخزن GitHub مراجعه کنید. اگر سؤال بیشتری دارید، با تیم پشتیبانی در فروم تماس بگیرید.