استرجاع وتحديث معلومات العرض التقديمي في C++

عن ماذا تتحدث هذه الصفحة

استكشف الشرائح والبنية والبيانات الوصفية في عروض PowerPoint وOpenDocument باستخدام C++ للحصول على رؤى أسرع وتدقيق محتوى أذكى.

نظرة عامة

يمكن لـ Aspose.Slides تحديد تنسيق العرض التقديمي وقراءة بيانات الوصف الوmetadata للوثيقة دون إنشاء نموذج كائن عرض تقديمي كامل. يكون هذا مفيدًا عندما تحتاج إلى تصنيف الملفات، بناء جرد، أو فحص الخصائص قبل اتخاذ قرار بشأن تحميل ومعالجة محتوى العرض التقديمي.

توضح هذه المقالة الفحص الخفيف الوزن من خلال PresentationFactory وIPresentationInfo، بالإضافة إلى تحديثات مستهدفة عبر IDocumentProperties.

التحقق من تنسيق العرض التقديمي

إذا كان لديك عرض تقديمي تم تحميله بالفعل، راجع Determine the Original Presentation Format للكشف بعد التحميل والقيود المتعلقة بتدفقات PPT وPPS وPOT القديمة.

استخدم IPresentationFactory::GetPresentationInfo لتفقد ملف دون إنشاء مثيل Presentation. تُبلغ طريقة IPresentationInfo::get_LoadFormat عن التنسيق المكتشف، مثل PPTX أو PPT أو ODP.

#include <DOM/IPresentationInfo.h>
#include <DOM/PresentationFactory.h>
#include <LoadFormat.h>
#include <system/array.h>
#include <system/console.h>
#include <system/object_ext.h>
#include <system/string.h>

using namespace Aspose::Slides;
using namespace System;

auto fileNames = MakeArray<String>({u"pres.pptx", u"pres.ppt", u"pres.odp"});

for (const auto& fileName : fileNames)
{
    auto presentationInfo = PresentationFactory::get_Instance()->GetPresentationInfo(fileName);
    Console::WriteLine(String::Format(u"{0}: {1}", fileName, ObjectExt::ToString(presentationInfo->get_LoadFormat())));
}

بناء جرد عرض تقديمي خفيف الوزن

عند معالجة العديد من ملفات العروض التقديمية، قد تحتاج إلى جرد مدمج للتحقق، الفهرسة، أو نظام إدارة المستندات. في هذا السيناريو، استخدم IPresentationFactory::GetPresentationInfo للحصول على كائن IPresentationInfo، ثم استدعِ IPresentationInfo::ReadDocumentProperties لقراءة بيانات وصف المستند. لا يُنشئ هذا النهج مثيلًا لـ Presentation ولا يتطلب التنقل عبر نموذج كائن العرض التقديمي الكامل.

توفر الخصائص الموسعة التي يكشف عنها IDocumentProperties القيم التالية للجرد:

Method	Inventory value
get_Slides	إجمالي عدد الشرائح.
get_HiddenSlides	عدد الشرائح المخفية.
get_Notes	عدد الشرائح التي تحتوي على ملاحظات.
get_Paragraphs	إجمالي عدد الفقرات، إذا كانت متوفرة.
get_Words	إجمالي عدد الكلمات.
get_MultimediaClips	إجمالي عدد مقاطع الصوت والفيديو.

المثال التالي يقرأ هذه القيم دون إنشاء كائن Presentation ويطبع جردًا مدمجًا. كما يجمع بين IDocumentProperties::get_HeadingPairs وIDocumentProperties::get_TitlesOfParts لعرض مجموعات المحتوى مثل الخطوط والسمات وعناوين الشرائح.

#include <DOM/IDocumentProperties.h>
#include <DOM/IHeadingPair.h>
#include <DOM/IPresentationInfo.h>
#include <DOM/PresentationFactory.h>
#include <LoadFormat.h>
#include <system/console.h>
#include <system/io/path.h>
#include <system/object_ext.h>
#include <system/string.h>

using namespace Aspose::Slides;
using namespace System;
using namespace System::IO;

auto filePath = String(u"sample.pptx");
auto presentationInfo = PresentationFactory::get_Instance()->GetPresentationInfo(filePath);
auto documentProperties = presentationInfo->ReadDocumentProperties();

Console::WriteLine(String::Format(u"File: {0}", Path::GetFileName(filePath)));
Console::WriteLine(String::Format(u"Format: {0}", ObjectExt::ToString(presentationInfo->get_LoadFormat())));
Console::WriteLine(String::Format(u"Title: {0}", documentProperties->get_Title()));
Console::WriteLine(String::Format(u"Author: {0}", documentProperties->get_Author()));
Console::WriteLine(u"Statistics:");
Console::WriteLine(String::Format(u"  Slides: {0}", documentProperties->get_Slides()));
Console::WriteLine(String::Format(u"  Hidden slides: {0}", documentProperties->get_HiddenSlides()));
Console::WriteLine(String::Format(u"  Slides with notes: {0}", documentProperties->get_Notes()));
Console::WriteLine(String::Format(u"  Paragraphs: {0}", documentProperties->get_Paragraphs()));
Console::WriteLine(String::Format(u"  Words: {0}", documentProperties->get_Words()));
Console::WriteLine(String::Format(u"  Multimedia clips: {0}", documentProperties->get_MultimediaClips()));

auto headingPairs = documentProperties->get_HeadingPairs();
auto titlesOfParts = documentProperties->get_TitlesOfParts();
auto partIndex = 0;

if (headingPairs == nullptr || titlesOfParts == nullptr || headingPairs->get_Length() == 0 || titlesOfParts->get_Length() == 0)
{
    Console::WriteLine(u"Content groups: not available");
}
else
{
    Console::WriteLine(u"Content groups:");

    for (const auto& headingPair : headingPairs)
    {
        auto partCount = headingPair->get_Count();
        Console::WriteLine(String::Format(u"  {0} ({1})", headingPair->get_Name(), partCount));

        for (auto partOffset = 0; partOffset < partCount && partIndex < titlesOfParts->get_Length(); partOffset++)
        {
            Console::WriteLine(String::Format(u"    - {0}", titlesOfParts[partIndex]));
            partIndex++;
        }
    }

    if (partIndex < titlesOfParts->get_Length())
    {
        Console::WriteLine(u"  Other parts:");

        while (partIndex < titlesOfParts->get_Length())
        {
            Console::WriteLine(String::Format(u"    - {0}", titlesOfParts[partIndex]));
            partIndex++;
        }
    }
}

كل IHeadingPair يوفر اسم المجموعة عبر IHeadingPair::get_Name وعدد العناصر في تلك المجموعة عبر IHeadingPair::get_Count. تُعيد IDocumentProperties::get_TitlesOfParts مصفوفة مسطحة مرتبة، لذا استهلك عدد العناوين المتتالية المحدد بواسطة كل زوج عنوان.

البيانات الوصفية المخزنة وقيود التنسيق

القيم التي تُرجعها خصائص الجرد عبر IPresentationInfo::ReadDocumentProperties تعكس البيانات الوصفية المتوفرة في المستند المصدر. لا يقوم Aspose.Slides بتحميل وتصفح نموذج كائن العرض التقديمي لإعادة حساب هذه القيم لهذا الاستدعاء. تُمثَّل الخصائص المفقودة بالقيم الافتراضية، وقد تكون القيم المخزنة قديمة إذا لم تُحدِّث التطبيق الذي حفظ الملف آخر مرة خصائص المستند.

PPTX: يوفر التنسيق خصائص مستند موسعة لعدد الشرائح، الملاحظات، الشرائح المخفية، الفقرات، الكلمات، والوسائط المتعددة، بالإضافة إلى أزواج العناوين وعناوين الأجزاء. تعتمد التوافرية على الخصائص التي كُتبت بواسطة مُنتج المستند.
PPT: يمكن للتنسيق الثنائي تخزين خصائص ملخص المستند المقابلة. إذا كانت الخاصية غائبة أو لم يُحدَّثها مُنتج المستند، تُعيد Aspose.Slides قيمتها المخزنة أو الافتراضية بدلاً من حسابها من الشرائح.
ODP: توفر بيانات OpenDocument إحصاءات عامة للمستند، مثل عدد الصفحات والفقرات والكلمات، لكن هذه القيم لا تتطابق مع كل خاصية موسعة خاصة بـ PowerPoint. قد تكون بيانات الشرائح المخفية، ملاحظات الشرائح، الوسائط المتعددة، أزواج العناوين، وعناوين الأجزاء غير متوفرة، وقد تُعيد خصائص الجرد قيمًا افتراضية. لا تُعامل القيمة الصفرية أو المصفوفة الفارغة كدليل نهائي على عدم وجود المحتوى المقابل.

استخدم نهج البيانات الوصفية الخفيف للجرد والفحوصات الأولية. حمِّل العرض التقديمي وتفقد نموذج كائنه الحي عندما يجب أن يعكس الناتج التغييرات في الذاكرة أو عندما تحتاج إلى التحقق من المحتوى الفعلي للعرض.

تحديث خصائص العرض التقديمي

يمكن أيضًا تعديل الخصائص التي تُرجعها IPresentationInfo::ReadDocumentProperties دون إنشاء مثيل Presentation. طبّق التغييرات باستخدام IPresentationInfo::UpdateDocumentProperties، ثم اكتب العرض التقديمي المرتبط عبر IPresentationInfo::WriteBindedPresentation.

الصورة التالية تُظهر خصائص المستند الأصلية.

Original document properties of the PowerPoint presentation

المثال التالي يغيّر العنوان ووقت الحفظ الأخير ويكتب النتيجة إلى ملف جديد:

#include <DOM/IDocumentProperties.h>
#include <DOM/IPresentationInfo.h>
#include <DOM/PresentationFactory.h>
#include <system/date_time.h>
#include <system/string.h>

using namespace Aspose::Slides;
using namespace System;

auto sourceFile = String(u"sample.pptx");
auto outputFile = String(u"sample_with_updated_properties.pptx");
auto presentationInfo = PresentationFactory::get_Instance()->GetPresentationInfo(sourceFile);
auto documentProperties = presentationInfo->ReadDocumentProperties();

documentProperties->set_Title(u"Quarterly sales report");
documentProperties->set_LastSavedTime(DateTime::get_UtcNow());

presentationInfo->UpdateDocumentProperties(documentProperties);
presentationInfo->WriteBindedPresentation(outputFile);

الصورة التالية تُظهر خصائص المستند المحدثة.

Changed document properties of the PowerPoint presentation

روابط مفيدة

للفحوصات الأمنية ذات الصلة وإعدادات الحماية، راجع المقالات التالية:

الأسئلة المتكررة

كيف يمكنني التحقق مما إذا كانت الخطوط مضمنة وأيها؟

حمِّل العرض التقديمي واستخدم Presentation::get_FontsManager. استدعِ FontsManager::GetEmbeddedFonts للحصول على الخطوط المضمَّنة وFontsManager::GetFonts للحصول على الخطوط المستخدمة في العرض. قارن النتيجتين لتحديد الخطوط المطلوبة للعرض ولكنها غير مضمنة.

كيف يمكنني بسرعة معرفة ما إذا كان الملف يحتوي على شرائح مخفية وعددها؟

عند كفاية بيانات الوصف المخزنة، اقرأ IDocumentProperties::get_HiddenSlides عبر IPresentationFactory::GetPresentationInfo وIPresentationInfo::ReadDocumentProperties. هذا مناسب لجرد خفيف الوزن. إذا تم تعديل العرض في الذاكرة، قد تكون البيانات الوصفية المخزنة مفقودة أو قديمة، أو تحتاج إلى التحقق من القيم الحية؛ عندها كرّر عبر Presentation::get_Slides وتفقد طريقة Slide::get_Hidden لكل شريحة.

هل يمكنني اكتشاف ما إذا كان حجم الشريحة المخصص واتجاهها مستخدمان، وما إذا كانا يختلفان عن القيم الافتراضية؟

نعم. حمِّل العرض التقديمي واقرأ Presentation::get_SlideSize. تفحص ISlideSize::get_Type، ISlideSize::get_Size، وISlideSize::get_Orientation لمقارنة الإعدادات الحالية مع الإعدادات المسبقة والأبعاد المتوقعة.

هل هناك طريقة سريعة لمعرفة ما إذا كانت المخططات تشير إلى مصادر بيانات خارجية؟

نعم. حدد كل Chart وتفحص ChartData::get_DataSourceType. للدفتر الخارجي، اقرأ ChartData::get_ExternalWorkbookPath. يحدد نوع مصدر البيانات والمسار إشارة إلى مرجع خارجي، لكن التحقق من توفر الهدف يتطلب فحص موارد منفصل.

كيف يمكنني تقييم “الشرائح الثقيلة” التي قد تبطئ العرض أو تصدير PDF؟

لا توجد خاصية تعقيد واحدة. كرّر عبر Presentation::get_Slides ومجموعة IBaseSlide::get_Shapes لكل شريحة. استخدم عدد الأشكال ووجود الصور الكبيرة أو التأثيرات أو الرسوم المتحركة أو الوسائط المتعددة كإشارات فرز، وقم بقياس عرض تمثيلي أو تصدير قبل اعتبار الشريحة عنق زجاجة أداء مؤكد.

فتح العروض في C++ تحديد تنسيق العرض التقديمي الأصلي في C++