فایل های پاورپوینت حاوی متادیتا یا ویژگی های سند هستند که اطلاعات بیشتری در مورد ارائه ارائه می دهند. اینها شامل اطلاعاتی مانند عنوان، تاریخ، نویسنده و غیره ارائه است. در این مقاله نحوه دسترسی و اصلاح ویژگی های ارائه شده در پاورپوینت با استفاده از ++C را خواهید آموخت.
- C++ API برای دسترسی و اصلاح ویژگیهای ارائههای پاورپوینت
- انواع خواص در ارائه پاورپوینت
- دسترسی به ویژگی های داخلی در ارائه های پاورپوینت
- ویژگی های داخلی را در ارائه های پاورپوینت اصلاح کنید
- ویژگی های سفارشی را در ارائه های پاورپوینت اضافه کنید
- دسترسی و اصلاح ویژگی های سفارشی در ارائه های پاورپوینت
C++ API برای دسترسی و اصلاح ویژگیهای ارائههای پاورپوینت
Aspose.Slides for C++ یک API C++ برای کار با فایل های پاورپوینت است. این به شما امکان می دهد بدون نیاز به نرم افزار اضافی فایل های پاورپوینت را ایجاد، بخوانید و به روز کنید. علاوه بر این، API به شما امکان می دهد به ویژگی های ارائه های پاورپوینت دسترسی داشته باشید و آن ها را تغییر دهید. میتوانید API را از طریق NuGet نصب کنید یا آن را مستقیماً از بخش Downloads دانلود کنید.
PM> Install-Package Aspose.Slides.Cpp
انواع خواص در ارائه پاورپوینت
دو نوع ویژگی در ارائه های پاورپوینت وجود دارد: داخلی و سفارشی. ویژگیهای داخلی اطلاعات کلی درباره ارائهها مانند عنوان، تاریخ و غیره را ذخیره میکنند. از سوی دیگر، ویژگیهای سفارشی اطلاعات سفارشی را در جفتهای کلید/مقدار ذخیره میکنند. بخشهای زیر نحوه افزودن، دسترسی و اصلاح ویژگیهای داخلی و سفارشی ارائههای پاورپوینت را پوشش میدهند.
با استفاده از C++ به ویژگی های داخلی در ارائه های پاورپوینت دسترسی پیدا کنید
مراحل زیر برای دسترسی به ویژگی های داخلی در ارائه های پاورپوینت آورده شده است.
- ابتدا فایل پاورپوینت را با استفاده از کلاس Presentation بارگذاری کنید.
- با استفاده از روش Presentation->getDocumentProperties() به ویژگی ها دسترسی پیدا کنید.
- ویژگی های فردی را با استفاده از شی IDocumentProperties با روش هایی مانند IDocumentProperties->getCategory()، IDocumentProperties->getAuthor() و غیره بخوانید.
کد نمونه زیر نحوه دسترسی به ویژگی های داخلی در ارائه های پاورپوینت با استفاده از C++ را نشان می دهد.
// مسیر فایل
const String sourceFilePath = u"SourceDirectory\\Slides\\SamplePresentation.pptx";
// فایل ارائه را بارگیری کنید
auto presentation = System::MakeObject<Presentation>(sourceFilePath);
// دریافت مرجع خواص سند
System::SharedPtr<IDocumentProperties> documentProperties = presentation->get_DocumentProperties();
// مقادیر ویژگی را چاپ کنید
System::Console::WriteLine(u"Category : {0}", documentProperties->get_Category());
System::Console::WriteLine(u"Current Status : {0}", documentProperties->get_ContentStatus());
System::Console::WriteLine(u"Creation Date : {0}", documentProperties->get_CreatedTime().ToString());
System::Console::WriteLine(u"Author : {0}", documentProperties->get_Author());
System::Console::WriteLine(u"Description : {0}", documentProperties->get_Comments());
System::Console::WriteLine(u"KeyWords : {0}", documentProperties->get_Keywords());
System::Console::WriteLine(u"Last Modified By : {0}", documentProperties->get_LastSavedBy());
System::Console::WriteLine(u"Supervisor : {0}", documentProperties->get_Manager());
System::Console::WriteLine(u"Modified Date : {0}", documentProperties->get_LastSavedTime().ToString());
System::Console::WriteLine(u"Presentation Format : {0}", documentProperties->get_PresentationFormat());
System::Console::WriteLine(u"Last Print Date : {0}", documentProperties->get_LastPrinted().ToString());
System::Console::WriteLine(u"Is Shared between producers : {0}", documentProperties->get_SharedDoc());
System::Console::WriteLine(u"Subject : {0}", documentProperties->get_Subject());
System::Console::WriteLine(u"Title : {0}", documentProperties->get_Title());
ویژگی های داخلی را در ارائه های پاورپوینت با استفاده از C++ تغییر دهید
مراحل زیر برای تغییر ویژگی های داخلی در ارائه های پاورپوینت آورده شده است.
- ابتدا فایل پاورپوینت را با استفاده از کلاس Presentation بارگذاری کنید.
- با استفاده از روش Presentation->getDocumentProperties() ویژگی های شی IDocumentProperties را بازیابی کنید.
- ویژگی ها را با استفاده از شی IDocumentProperties با روش هایی مانند IDocumentProperties->setAuthor(System::String value)، IDocumentProperties->setTitle(System::String value) و غیره تغییر دهید. .
- در نهایت، ارائه را با استفاده از روش Presentation->Save(System::String fname, Export::SaveFormat format) ذخیره کنید.
کد نمونه زیر نحوه تغییر ویژگی های پاورپوینت داخلی را با استفاده از C++ نشان می دهد.
// مسیرهای فایل
const String sourceFilePath = u"SourceDirectory\\Slides\\SamplePresentation.pptx";
const String outputFilePath = u"OutputDirectory\\ModifyBuiltinProperties_out.pptx";
// فایل ارائه را بارگیری کنید
auto presentation = System::MakeObject<Presentation>(sourceFilePath);
// دریافت مرجع خواص سند
System::SharedPtr<IDocumentProperties> documentProperties = presentation->get_DocumentProperties();
// ویژگی های داخلی را اصلاح کنید
documentProperties->set_Author(u"Aspose.Slides for C++");
documentProperties->set_Title(u"Modifying Presentation Properties");
documentProperties->set_Subject(u"Aspose Subject");
documentProperties->set_Comments(u"Aspose Comments");
documentProperties->set_Manager(u"Aspose Manager");
// ذخیره ارائه
presentation->Save(outputFilePath, Aspose::Slides::Export::SaveFormat::Pptx);
ویژگی های سفارشی را در ارائه های پاورپوینت با استفاده از C++ اضافه کنید
مراحل زیر برای افزودن ویژگی های سفارشی در ارائه های پاورپوینت آورده شده است.
- ابتدا فایل پاورپوینت را با استفاده از کلاس Presentation بارگذاری کنید.
- با استفاده از روش Presentation->getDocumentProperties() خصوصیات شی IDocumentProperties را بازیابی کنید.
- ویژگی های سفارشی را با استفاده از IDocumentProperties->idxset(System::String name, System::SharedPtr اضافه کنیدSystem::Object مقدار) روش.
- در نهایت، ارائه را با استفاده از روش Presentation->Save(System::String fname, Export::SaveFormat format) ذخیره کنید.
کد نمونه زیر نحوه افزودن ویژگی های سفارشی در ارائه های پاورپوینت را نشان می دهد.
// مسیرهای فایل
const String sourceFilePath = u"SourceDirectory\\Slides\\SamplePresentation.pptx";
const String outputFilePath = u"OutputDirectory\\AddCustomProperties_out.pptx";
// فایل ارائه را بارگیری کنید
auto presentation = System::MakeObject<Presentation>(sourceFilePath);
// دریافت مرجع خواص سند
auto documentProperties = presentation->get_DocumentProperties();
// افزودن ویژگی های سفارشی
documentProperties->idx_set(u"New Custom", ObjectExt::Box<int32_t>(12));
documentProperties->idx_set(u"My Name", ObjectExt::Box<String>(u"Aspose"));
documentProperties->idx_set(u"Custom", ObjectExt::Box<int32_t>(124));
// دریافت نام ملک در شاخص خاص
String getPropertyName = documentProperties->GetCustomPropertyName(2);
// حذف ویژگی انتخاب شده
documentProperties->RemoveCustomProperty(getPropertyName);
// ذخیره ارائه
presentation->Save(outputFilePath, Aspose::Slides::Export::SaveFormat::Pptx);
دسترسی و اصلاح ویژگی های سفارشی در ارائه های پاورپوینت
مراحل زیر برای دسترسی و اصلاح ویژگی های سفارشی در ارائه های پاورپوینت آورده شده است.
- ابتدا فایل پاورپوینت را با استفاده از کلاس Presentation بارگذاری کنید.
- با استفاده از روش Presentation->getDocumentProperties() ویژگی های شی IDocumentProperties را بازیابی کنید.
- با استفاده از روشهای IDocumentProperties->GetCustomPropertyName(int32t index) و IDocumentProperties->idxget(System::String name) در میان ویژگیها حلقه بزنید و به نام و مقدار هر ویژگی دسترسی داشته باشید.
- ویژگی های سفارشی مورد نیاز را با استفاده از روش IDocumentProperties->SetCustomPropertyValue() بر اساس نوع مقداری که می خواهید ذخیره کنید، تغییر دهید.
- در نهایت، ارائه را با استفاده از روش Presentation->Save(System::String fname, Export::SaveFormat format) ذخیره کنید.
کد نمونه زیر نحوه دسترسی و اصلاح ویژگی های سفارشی در ارائه های پاورپوینت با استفاده از ++C را نشان می دهد.
// مسیرهای فایل
const String sourceFilePath = u"SourceDirectory\\Slides\\SamplePresentation.pptx";
const String outputFilePath = u"OutputDirectory\\AccessAndModifyCustomProperties_out.pptx";
// فایل ارائه را بارگیری کنید
auto presentation = System::MakeObject<Presentation>(sourceFilePath);
// یک مرجع به شی DocumentProperties مرتبط با Presentation ایجاد کنید
System::SharedPtr<IDocumentProperties> documentProperties = presentation->get_DocumentProperties();
// دسترسی به خواص سفارشی
for (int32_t i = 0; i < documentProperties->get_CountOfCustomProperties(); i++)
{
// نام و ارزش خواص سفارشی را چاپ کنید
System::Console::WriteLine(u"Custom Property Name : {0}", documentProperties->GetCustomPropertyName(i));
System::Console::WriteLine(u"Custom Property Value : {0}", documentProperties->idx_get(documentProperties->GetCustomPropertyName(i)));
// ویژگی سفارشی را اصلاح کنید
documentProperties->SetCustomPropertyValue(documentProperties->GetCustomPropertyName(i), String::Format(u"Title : {0}", i));
}
// ذخیره ارائه
presentation->Save(outputFilePath, Aspose::Slides::Export::SaveFormat::Pptx);
مجوز رایگان دریافت کنید
به منظور امتحان کردن API بدون محدودیت ارزیابی، می توانید [یک مجوز موقت رایگان] درخواست کنید.
نتیجه
در این مقاله نحوه دسترسی و اصلاح ویژگی های داخلی در ارائه های پاورپوینت را یاد گرفتید. علاوه بر این، نحوه افزودن، دسترسی و اصلاح ویژگی های پاورپوینت سفارشی را با استفاده از Aspose.Slides برای C++ API مشاهده کرده اید. این یک API قوی با بسیاری از ویژگیهای اضافی برای خودکارسازی وظایف مرتبط با پاورپوینت است. میتوانید با مراجعه به مستندات رسمی API را با جزئیات بررسی کنید. در صورت وجود هرگونه سوال، لطفاً با ما در تالار گفتمان پشتیبانی رایگان تماس بگیرید.