رایج ترین و پرکاربردترین فرمت های فایل ارائه PPT، PPTX و ODP هستند. پاورپوینت معروف مایکروسافت، OpenOffice Impress و Apple Keynote از این فرمت ها پشتیبانی می کنند و ما معمولا از این فرمت ها برای ارائه نمایش های دیدنی استفاده می کنیم. بهعنوان یک توسعهدهنده، میتوانیم ارائهها را در برنامههای خود به صورت برنامهنویسی ویرایش کنیم. در این مقاله، نحوه ویرایش ارائههای PPT/PPTX در C# با استفاده از NET API برای ویرایش ارائه بحث خواهیم کرد.
موضوعات زیر به طور خلاصه در این مقاله مورد بحث قرار گرفته است:
NET API برای ویرایش و اتوماسیون ارائه ها
اکنون، ما از GroupDocs.Editor برای .NET در مثال های زیر C# استفاده خواهیم کرد. این API ویرایش ارائه است و به توسعه دهندگان اجازه می دهد تا ارائه های ویرایش شده را در قالب های دیگری مانند PPT، PPTX، PDF بارگیری، ویرایش و ذخیره کنند. علاوه بر فرمتهای ارائه، API از ویرایش اسناد پردازش کلمه، صفحات گسترده، HTML، XML، JSON، TXT، TSV و فرمتهای CSV پشتیبانی میکند.
نصب کننده DLL یا MSI را از بخش دانلودها دانلود کنید یا API را از طریق NuGet در برنامه .NET خود نصب کنید.
PM> Install-Package GroupDocs.Editor
ویرایش PPTX/PPTX ارائه ها در C#
درست پس از راه اندازی API، می توانید به سرعت به سمت ویرایش اسلایدهای ارائه خود بروید. مراحل زیر به شما امکان می دهد ارائه PPT/PPTX و سایر فرمت های پشتیبانی شده را ویرایش کنید.
- ارائه را بارگیری کنید.
- با استفاده از گزینه های موجود ویرایش کنید.
- ارائه ویرایش شده را ذخیره کنید.
ارائه PPT/PPTX را بارگیری کنید
ابتدا، در صورت محافظت از ارائه، با ارائه مسیر فایل ارائه و رمز عبور، ارائه را بارگذاری کنید.
// Load Presentation
using (FileStream fs = File.OpenRead("path/presentation.pptx"))
{
// Load Presentation
Options.PresentationLoadOptions loadOptions = new PresentationLoadOptions();
loadOptions.Password = "P@$$w0Rd";
}
اسلایدهای ارائه PPT/PPTX را ویرایش کنید
پس از بارگذاری، می توانید ارائه بارگذاری شده را مطابق با نیاز ویرایش کنید. در اینجا من با استفاده از کد C# زیر، تمام رخدادهای کلمه “اسناد” را با “ارائه” در یک ارائه PPTX جایگزین می کنم.
// Edit Presentation
using (Editor editor = new Editor(delegate { return fs; }, delegate { return loadOptions; }))
{
Options.PresentationEditOptions editOptions = new PresentationEditOptions();
editOptions.SlideNumber = 0; // 1st slide
editOptions.ShowHiddenSlides = true;
using (EditableDocument beforeEdit = editor.Edit(editOptions))
{
string originalContent = beforeEdit.GetContent();
List<IHtmlResource> allResources = beforeEdit.AllResources;
string editedContent = originalContent.Replace("documents", "presentation");
}
}
ارائه پاورپوینت ویرایش شده را با گزینه ها ذخیره کنید
در نهایت، در حالی که محتوای ارائه ویرایش شده را ذخیره می کنید، می توانید گزینه های مختلفی را تنظیم کنید. این گزینه ها عبارتند از تنظیم رمز عبور، تنظیمات فرمت خروجی. من گزینه های بالا را در کد زیر تنظیم می کنم و ارائه ویرایش شده را به عنوان یک فایل PPTX محافظت شده با رمز عبور ذخیره می کنم.
// Save Presentation
using (EditableDocument afterEdit = EditableDocument.FromMarkup(editedContent, allResources))
{
Options.PresentationSaveOptions saveOptions = new PresentationSaveOptions(PresentationFormats.Pptm);
saveOptions.Password = "new_pa$$word";
using (FileStream outputStream = File.Create("path/edited-presentation.pptx"))
{
editor.Save(afterEdit, outputStream, saveOptions);
}
}
کد کامل
برای راحتی، در اینجا مثال کامل C# است که در بالا توضیح داده شده است و ارائه پاورپوینت را ویرایش می کند و سپس آن را در قالب PPTX ذخیره می کند.
// ویرایش PPT/PPTX ارائه شده در C# با استفاده از ویرایش ارائه و اتوماسیون API GroupDocs
using (FileStream fs = File.OpenRead("path/presentation.pptx"))
{
// بارگذاری ارائه
Options.PresentationLoadOptions loadOptions = new PresentationLoadOptions();
loadOptions.Password = "P@$$w0Rd";
// ویرایش ارائه
using (Editor editor = new Editor(delegate { return fs; }, delegate { return loadOptions; }))
{
Options.PresentationEditOptions editOptions = new PresentationEditOptions();
editOptions.SlideNumber = 0; // 1st slide
editOptions.ShowHiddenSlides = true;
using (EditableDocument beforeEdit = editor.Edit(editOptions))
{
string originalContent = beforeEdit.GetContent();
List<IHtmlResource> allResources = beforeEdit.AllResources;
string editedContent = originalContent.Replace("documents", "presentation");
// ذخیره ارائه
using (EditableDocument afterEdit = EditableDocument.FromMarkup(editedContent, allResources))
{
Options.PresentationSaveOptions saveOptions = new PresentationSaveOptions(PresentationFormats.Pptm);
saveOptions.Password = "new_pa$$word";
using (FileStream outputStream = File.Create("path/edited-presentation.pptx"))
{
editor.Save(afterEdit, outputStream, saveOptions);
}
}
}
}
}
در زیر ارائه خروجی است که در آن تمام رخدادها با استفاده از کد بالا جایگزین می شوند.
نتیجه
برای نتیجه گیری، در مورد ویرایش اسلایدهای ارائه در C# با استفاده از API ویرایش ارائه برای برنامه های NET بحث کردیم. می توانید از API با ویرایشگرهای WYSIWYG برای ویرایش بصری ارائه های خود استفاده کنید. پس از آن، می توانید برای ساختن ویرایشگر ارائه خود پیش بروید. به طور مشابه، شما همچنین می توانید ویژگی ویرایش را در برنامه .NET خود ادغام کنید.
برای جزئیات بیشتر، گزینهها و مثالها، میتوانید از اسناد و مخزن GitHub دیدن کنید. برای سوالات بیشتر، با پشتیبانی در فروم تماس بگیرید.