以 C++ 取得與更新簡報資訊

本頁內容簡介

探索在 PowerPoint 與 OpenDocument 簡報中使用 C++ 進行幻燈片、結構與中繼資料的快速洞察與智慧內容稽核。

概觀

Aspose.Slides 能夠辨識簡報的格式，並在不建立完整簡報物件模型的情況下讀取其文件中繼資料。這在需要對檔案分類、建立清單，或在決定是否載入與處理簡報內容之前檢查屬性時非常有用。

本文示範如何透過 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 暴露的延伸屬性提供以下清單值：

方法	清單值
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 寫入已綁定的簡報。

下圖顯示原始文件屬性。

PowerPoint 簡報的原始文件屬性

以下範例會變更標題與最後儲存時間，並將結果寫入新檔案：

#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);

PowerPoint 簡報的變更後文件屬性

常見問題

如何檢查字型是否已嵌入以及是哪一些字型？

載入簡報並使用 Presentation::get_FontsManager。呼叫 FontsManager::GetEmbeddedFonts 取得已嵌入的字型，並呼叫 FontsManager::GetFonts 取得簡報使用的字型。將兩者結果進行比較，即可找出渲染所需但未嵌入的字型。

如何快速判斷檔案是否有隱藏投影片以及其數量？

當儲存的文件中繼資料足夠時，可透過 IPresentationFactory::GetPresentationInfo 以及 IPresentationInfo::ReadDocumentProperties 讀取 IDocumentProperties::get_HiddenSlides。這適用於輕量清單。若簡報已在記憶體中被修改，儲存的中繼資料可能缺失或過時，或需要驗證即時值，則應遍歷 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++ 中判斷原始簡報格式