مدیریت برچسبها و دادههای سفارشی در ارائهها با استفاده از C++
نمای کلی
این مقاله توضیح میدهد که Aspose.Slides چگونه با برچسبها و دادههای سفارشی در ارائههای PowerPoint کار میکند. بهطور خلاصه نحوه ذخیرهسازی دادهها در فایلهای PPTX را بیان میکند، اشاره میکند که دادههای مخصوص به ارائه میتواند بهصورت برچسبها و بخشهای XML سفارشی وجود داشته باشد، و برچسبها را بهعنوان جفتهای کلید‑مقدار رشتهای توصیف میکند. همچنین نشان میدهد چگونه مقادیر برچسبها را بخوانید و چگونه برچسبها را به یک ارائه، یک اسلاید منفرد یا یک شکل اضافه کنید. علاوه بر این، مقاله به وظایف معمول مدیریت برچسب مانند پاکسازی تمام برچسبها، حذف برچسب بر اساس نام و بازیابی لیست نامهای برچسب میپردازد.
ذخیرهسازی دادهها در فایلهای ارائه
فایلهای PPTX—آیتمهایی با پسوند .pptx—در قالب PresentationML ذخیره میشوند که بخشی از مشخصات Office Open XML است. فرمت Office Open XML ساختار دادههای موجود در ارائهها را تعریف میکند.
یک اسلاید یکی از عناصر موجود در ارائهها است و یک بخش اسلاید شامل محتوای یک اسلاید واحد میشود. یک بخش اسلاید میتواند روابط صریحی با بسیاری از بخشها—مانند برچسبهای تعریفشده توسط کاربر—که توسط ISO/IEC 29500 تعریف شدهاند، داشته باشد.
دادههای سفارشی (خاص یک ارائه) یا کاربر میتواند بهصورت برچسبها (ITagCollection) و CustomXmlParts (ICustomXmlPartCollection) وجود داشته باشد.
دریافت مقادیر برچسبها
در اسلایدها، یک برچسب معادل ویژگی IDocumentProperties.Keywords است. این کد نمونه نشان میدهد چگونه مقدار یک برچسب را با Aspose.Slides برای C++ برای Presentation دریافت کنید:
auto pres = System::MakeObject<Presentation>(u"pres.pptx");
System::String keywords = pres->get_DocumentProperties()->get_Keywords();
افزودن برچسبها به ارائهها
Aspose.Slides به شما امکان میدهد برچسبها را به ارائهها اضافه کنید. یک برچسب معمولاً شامل دو مورد است:
- نام یک ویژگی سفارشی -
MyTag - مقدار ویژگی سفارشی -
My Tag Value
اگر نیاز دارید برخی از ارائهها را بر اساس قاعده یا ویژگی خاصی طبقهبندی کنید، میتوانید از افزودن برچسبها به آن ارائهها بهره ببرید. بهعنوان مثال، اگر میخواهید تمام ارائههای کشورهای آمریکای شمالی را دستهبندی یا گروهبندی کنید، میتوانید یک برچسب North American ایجاد کرده و کشورهای مرتبط (ایالات متحده، مکزیک و کانادا) را بهعنوان مقادیر اختصاص دهید.
این کد نمونه نشان میدهد چگونه یک برچسب به یک Presentation اضافه کنید با استفاده از Aspose.Slides برای C++:
auto pres = System::MakeObject<Presentation>(u"pres.pptx");
System::SharedPtr<ITagCollection> tags = pres->get_CustomData()->get_Tags();
pres->get_CustomData()->get_Tags()->idx_set(u"MyTag", u"My Tag Value");
برچسبها همچنین میتوانند برای Slide تنظیم شوند:
auto pres = System::MakeObject<Presentation>();
auto slide = pres->get_Slides()->idx_get(0);
slide->get_CustomData()->get_Tags()->idx_set(u"tag", u"value");
یا برای هر Shape بهصورت منفرد:
auto pres = System::MakeObject<Presentation>();
auto slide = pres->get_Slides()->idx_get(0);
auto shape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 10.0f, 10.0f, 100.0f, 50.0f);
shape->get_TextFrame()->set_Text(u"My text");
shape->get_CustomData()->get_Tags()->idx_set(u"tag", u"value");
محدودیتها
برچسبهایی که از طریق مجموعه برچسبهای داده سفارشی با استفاده از get_CustomData()->get_Tags() اضافه میشوند، فقط در فایل PowerPoint ذخیره میشوند. آنها به ساختار برچسبهای PDF هنگام صادر کردن ارائه به PDF منتقل نمیشوند. در نتیجه، یک شناسه سفارشی که بهعنوان برچسب اختصاص داده شده است، نمیتواند از PDF دارای برچسب بازیابی شود.
راهحل: میتوانید یک شناسه سفارشی را در متن جایگزین (Alt Text) شیء ذخیره کنید (مثال: shape->set_AlternativeText(u"MyId")). پس از صادر کردن به PDF، Alt Text ممکن است در ساختار برچسبهای PDF ظاهر شود.
سؤالات متداول
آیا میتوانم تمام برچسبها را از یک ارائه، اسلاید یا شکل در یک عملیات حذف کنم؟
بله. tag collection از عملیات clear پشتیبانی میکند که تمام جفتهای کلید‑مقدار را یکباره حذف مینماید.
چگونه میتوان یک برچسب تک را بر اساس نام آن حذف کرد بدون اینکه کل مجموعه را مرور کنم؟
از عملیات Remove(name) بر روی TagCollection استفاده کنید تا برچسب را بر اساس کلید (نام) آن حذف کنید.
چگونه میتوان لیست کامل نامهای برچسب را برای تحلیل یا فیلتر کردن دریافت کرد؟
از GetNamesOfTags بر روی tag collection استفاده کنید؛ این متد یک آرایه شامل تمام نامهای برچسب را برمیگرداند.