使用 C++ 管理簡報中的投影片轉場

本頁內容簡介

使用 Aspose.Slides for C++ 套用投影片轉場、設定自動投影片前進，並自訂 Morph 及其他轉場效果。

概述

投影片轉場控制投影片在投影片放映期間的呈現方式。使用 Aspose.Slides for C++，您可以為每張投影片選擇轉場效果、設定點擊或計時器的前進方式，並調整特定於效果的選項。本文以 C++ 範例說明如何套用轉場、設定精確的轉場持續時間、管理投影片計時，並在兩張投影片之間建立 Morph 轉場。範例同時示範如何將設定儲存為 PPTX 檔案。

新增投影片轉場

若要套用轉場，請使用簡報類別載入簡報，並透過 get_SlideShowTransition 取得投影片的轉場設定。呼叫 set_Type，傳入來自 TransitionType 列舉的值，之後儲存簡報。

下列範例將 Circle 轉場套用於第一張投影片，將 Comb 轉場套用於第二張投影片。請使用至少包含兩張投影片的 input.pptx 檔案。

#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/ISlideShowTransition.h>
#include <DOM/SlideShowTransition/TransitionType.h>
#include <Export/SaveFormat.h>
#include <system/console.h>

using namespace System;
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace Aspose::Slides::SlideShow;

auto presentation = MakeObject<Presentation>(u"input.pptx");

if (presentation->get_Slides()->get_Count() >= 2)
{
    presentation->get_Slide(0)->get_SlideShowTransition()->set_Type(TransitionType::Circle);
    presentation->get_Slide(1)->get_SlideShowTransition()->set_Type(TransitionType::Comb);

    presentation->Save(u"slide-transitions.pptx", SaveFormat::Pptx);
}
else
{
    Console::WriteLine(u"The input presentation must contain at least two slides.");
}

presentation->Dispose();

新增進階投影片轉場

您可以設定投影片在螢幕上停留的時間，以及是否透過滑鼠點擊前進投影片放映。以下方法控制此行為：

set_AdvanceOnClick 允許觀眾點擊滑鼠前進。
set_AdvanceAfter 啟用自動前進。
set_AdvanceAfterTime 指定自動前進前的延遲時間（毫秒）。

同時啟用點擊與計時前進，讓觀眾可點擊前進或等待計時器。若只想使用計時器，請以 false 呼叫 set_AdvanceOnClick。延遲時間只決定何時前進投影片放映，並不設定視覺轉場效果的持續時間。

此範例將不同的效果分別套用於前三張投影片，並分別在 3、5、7 秒後自動前進。滑鼠點擊同樣可以前進這些投影片。請使用至少包含三張投影片的 input.pptx 檔案。

#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/ISlideShowTransition.h>
#include <DOM/SlideShowTransition/TransitionType.h>
#include <Export/SaveFormat.h>
#include <system/console.h>

using namespace System;
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace Aspose::Slides::SlideShow;

auto presentation = MakeObject<Presentation>(u"input.pptx");

if (presentation->get_Slides()->get_Count() >= 3)
{
    auto firstTransition = presentation->get_Slide(0)->get_SlideShowTransition();
    firstTransition->set_Type(TransitionType::Circle);
    firstTransition->set_AdvanceOnClick(true);
    firstTransition->set_AdvanceAfter(true);
    firstTransition->set_AdvanceAfterTime(3000);

    auto secondTransition = presentation->get_Slide(1)->get_SlideShowTransition();
    secondTransition->set_Type(TransitionType::Comb);
    secondTransition->set_AdvanceOnClick(true);
    secondTransition->set_AdvanceAfter(true);
    secondTransition->set_AdvanceAfterTime(5000);

    auto thirdTransition = presentation->get_Slide(2)->get_SlideShowTransition();
    thirdTransition->set_Type(TransitionType::Zoom);
    thirdTransition->set_AdvanceOnClick(true);
    thirdTransition->set_AdvanceAfter(true);
    thirdTransition->set_AdvanceAfterTime(7000);

    presentation->Save(u"advanced-transitions.pptx", SaveFormat::Pptx);
}
else
{
    Console::WriteLine(u"The input presentation must contain at least three slides.");
}

presentation->Dispose();

若要檢查是否已啟用計時前進，請呼叫 get_AdvanceAfter。僅儲存的延遲值並不表示計時器已啟動。

下一個範例開啟上述儲存的檔案，報告每個已啟用的計時器，並對延遲超過兩秒的投影片停用自動前進。對這些投影片重新啟用滑鼠點擊，最後儲存更新後的設定。

#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/ISlideShowTransition.h>
#include <Export/SaveFormat.h>
#include <system/console.h>

using namespace System;
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

auto presentation = MakeObject<Presentation>(u"advanced-transitions.pptx");

for (auto&& slide : presentation->get_Slides())
{
    auto transition = slide->get_SlideShowTransition();

    if (transition->get_AdvanceAfter())
    {
        Console::WriteLine(u"Slide {0}: advance after {1} ms.", slide->get_SlideNumber(), transition->get_AdvanceAfterTime());

        if (transition->get_AdvanceAfterTime() > 2000)
        {
            transition->set_AdvanceAfter(false);
            transition->set_AdvanceOnClick(true);
        }
    }
}

presentation->Save(u"adjusted-transitions.pptx", SaveFormat::Pptx);

presentation->Dispose();

精確控制轉場時機

使用 set_Duration 以毫秒為單位指定轉場效果的確切長度。投影片的 get_SlideShowTransition 方法透過 ISlideShowTransition 暴露這些設定：

方法	用途
set_Duration	設定轉場效果本身的持續時間（毫秒）。
set_AdvanceAfterTime	設定投影片自動前進前的延遲（毫秒）。呼叫 set_AdvanceAfter 並傳入 `true` 以啟用計時器。
set_Speed	從 TransitionSpeed 中選擇預先定義的速度類別：Slow、Medium 或 Fast。當未指定確切持續時間時使用此設定。

set_Duration 僅控制轉場效果本身；它不決定投影片在螢幕上停留的時間。請另行設定自動前進的延遲時間。若未設定明確的持續時間，Aspose.Slides 會根據轉場類型與 get_Speed 返回的值推算效果持續時間。

將相同持續時間套用於每張投影片

為了保持節奏一致，請將相同的效果與精確持續時間套用於每張投影片。此範例載入 input.pptx，從 TransitionType 中選取 Fade，並為每個轉場設定 750 毫秒的持續時間。接著分別啟用 5,000 毫秒的自動前進，並停用滑鼠點擊前進，最後將結果儲存為 PPTX。

#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/ISlideShowTransition.h>
#include <DOM/SlideShowTransition/TransitionType.h>
#include <Export/SaveFormat.h>

using namespace System;
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace Aspose::Slides::SlideShow;

auto presentation = MakeObject<Presentation>(u"input.pptx");

for (auto&& slide : presentation->get_Slides())
{
    auto transition = slide->get_SlideShowTransition();
    transition->set_Type(TransitionType::Fade);
    transition->set_Duration(750);

    // 獨立於效果持續時間設定自動前進。
    transition->set_AdvanceAfter(true);
    transition->set_AdvanceAfterTime(5000);
    transition->set_AdvanceOnClick(false);
}

presentation->Save(u"precise-transitions.pptx", SaveFormat::Pptx);

presentation->Dispose();

為單獨投影片設定不同持續時間

不同的投影片可以使用不同的效果持續時間。例如，為標題投影片使用較短的轉場，為章節介紹使用較長的轉場。此範例為第一張投影片設定 500 毫秒，為第二張投影片設定 1,200 毫秒。請使用至少包含兩張投影片的 input.pptx 檔案。

#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/ISlideShowTransition.h>
#include <DOM/SlideShowTransition/TransitionType.h>
#include <Export/SaveFormat.h>
#include <system/console.h>

using namespace System;
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace Aspose::Slides::SlideShow;

auto presentation = MakeObject<Presentation>(u"input.pptx");

if (presentation->get_Slides()->get_Count() >= 2)
{
    auto firstTransition = presentation->get_Slide(0)->get_SlideShowTransition();
    firstTransition->set_Type(TransitionType::Fade);
    firstTransition->set_Duration(500);

    auto secondTransition = presentation->get_Slide(1)->get_SlideShowTransition();
    secondTransition->set_Type(TransitionType::Push);
    secondTransition->set_Duration(1200);

    presentation->Save(u"individual-transition-durations.pptx", SaveFormat::Pptx);
}
else
{
    Console::WriteLine(u"The input presentation must contain at least two slides.");
}

presentation->Dispose();

與動畫輸出協調轉場

在製作 animated GIF、HTML5 簡報或影片時，請在匯出前設定精確的轉場持續時間，以符合預期節奏。例如，場景之間使用 600 毫秒的淡入淡出，並分別調整每張投影片的前進延遲，以允許旁白或內容的播放時間。

對於 GIF 與影片，請將輸出幀率與效果持續時間對齊：600 毫秒相當於 30 fps 下的 18 幀。於 HTML5，請在匯出設定中啟用動畫轉場。檢查所選匯出格式支援的效果與計時選項，並預覽輸出以確保同步。

讀取現有的轉場持續時間

在修改轉場之前，先呼叫 get_Duration 以判斷是否已儲存明確的值。-1 表示未設定明確持續時間；非負值則表示以毫秒為單位的已儲存持續時間。未設定的值並非計算出的播放時長：Aspose.Slides 會根據轉場類型與 get_Speed 的返回值決定該時長。設定轉場類型可能會初始化持續時間，因此請先檢查原始設定。

#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/ISlideShowTransition.h>
#include <DOM/SlideShowTransition/TransitionType.h>
#include <DOM/SlideShowTransition/TransitionSpeed.h>
#include <system/console.h>

using namespace System;
using namespace Aspose::Slides;

auto presentation = MakeObject<Presentation>(u"input.pptx");

for (auto&& slide : presentation->get_Slides())
{
    auto transition = slide->get_SlideShowTransition();
    auto duration = transition->get_Duration();

    if (duration >= 0)
    {
        Console::WriteLine(u"Slide {0}: stored transition duration is {1} ms.", slide->get_SlideNumber(), duration);
    }
    else
    {
        Console::WriteLine(u"Slide {0}: no explicit duration; timing depends on {1} and {2}.", slide->get_SlideNumber(), transition->get_Type(), transition->get_Speed());
    }
}

presentation->Dispose();

Morph 轉場

Morph 轉場會在連續投影片之間動畫化物件的變化。建立簡易 Morph 效果的做法是：複製投影片、在複製品上移動或調整物件大小，然後將 Morph 轉場套用於第二張投影片。這樣可讓對應物件在原始與修改後的狀態之間動畫化。

以下範例建立一張含文字矩形的投影片，複製該投影片，並在複製品上變更矩形的位置與大小。接著為第二張投影片從 TransitionType 列舉中選取 Morph。於支援 Morph 的簡報檢視器中開啟已儲存的檔案，即可在投影片放映時看到效果。

#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/ISlideShowTransition.h>
#include <DOM/IAutoShape.h>
#include <DOM/IShape.h>
#include <DOM/IShapeCollection.h>
#include <DOM/ITextFrame.h>
#include <DOM/ShapeType.h>
#include <DOM/SlideShowTransition/TransitionType.h>
#include <Export/SaveFormat.h>

using namespace System;
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace Aspose::Slides::SlideShow;

auto presentation = MakeObject<Presentation>();

auto firstSlide = presentation->get_Slide(0);
auto rectangle = firstSlide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 100, 100, 400, 100);
rectangle->get_TextFrame()->set_Text(u"Morph transition");

auto secondSlide = presentation->get_Slides()->AddClone(firstSlide);
auto movedRectangle = secondSlide->get_Shape(0);
movedRectangle->set_X(movedRectangle->get_X() + 100);
movedRectangle->set_Y(movedRectangle->get_Y() + 50);
movedRectangle->set_Width(movedRectangle->get_Width() - 200);
movedRectangle->set_Height(movedRectangle->get_Height() - 10);

secondSlide->get_SlideShowTransition()->set_Type(TransitionType::Morph);

presentation->Save(u"morph-transition.pptx", SaveFormat::Pptx);

presentation->Dispose();

Morph 轉場類型

TransitionMorphType 列舉決定 Morph 如何匹配與動畫化內容：

ByObject 將每個圖形視為整體物件。
ByWord 盡可能以單字匹配方式動畫化文字。
ByChar 盡可能以字元匹配方式動畫化文字。

先以 Morph 呼叫 set_Type，再存取 get_Value。取得的值會提供 IMorphTransition 介面，使用其 set_MorphType 方法選擇匹配模式。

此範例開啟前一節建立的簡報，並將第二張投影片設定為以單字為單位的 Morph 動畫。

#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/ISlideShowTransition.h>
#include <DOM/SlideShowTransition/IMorphTransition.h>
#include <DOM/SlideShowTransition/ITransitionValueBase.h>
#include <DOM/SlideShowTransition/TransitionMorphType.h>
#include <DOM/SlideShowTransition/TransitionType.h>
#include <Export/SaveFormat.h>
#include <system/console.h>
#include <system/object_ext.h>

using namespace System;
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace Aspose::Slides::SlideShow;

auto presentation = MakeObject<Presentation>(u"morph-transition.pptx");

if (presentation->get_Slides()->get_Count() >= 2)
{
    auto transition = presentation->get_Slide(1)->get_SlideShowTransition();
    transition->set_Type(TransitionType::Morph);

    auto morphTransition = AsCast<IMorphTransition>(transition->get_Value());
    if (morphTransition != nullptr)
    {
        morphTransition->set_MorphType(TransitionMorphType::ByWord);
        presentation->Save(u"morph-by-word.pptx", SaveFormat::Pptx);
    }
    else
    {
        Console::WriteLine(u"Morph transition options are unavailable.");
    }
}
else
{
    Console::WriteLine(u"The input presentation must contain at least two slides.");
}

presentation->Dispose();

設定轉場效果

某些轉場會曝光額外選項，例如方向或是否從黑畫面開始。可用的選項取決於所選的轉場類型。先設定類型，然後使用 get_Value 回傳的相應介面。

以下範例對 input.pptx 的第一張投影片套用 Cut 轉場，並透過 IOptionalBlackTransition 呼叫 set_FromBlack 並傳入 true，使轉場從黑畫面開始。

#include <DOM/Presentation.h>
#include <DOM/ISlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/ISlideShowTransition.h>
#include <DOM/SlideShowTransition/IOptionalBlackTransition.h>
#include <DOM/SlideShowTransition/ITransitionValueBase.h>
#include <DOM/SlideShowTransition/TransitionType.h>
#include <Export/SaveFormat.h>
#include <system/console.h>
#include <system/object_ext.h>

using namespace System;
using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace Aspose::Slides::SlideShow;

auto presentation = MakeObject<Presentation>(u"input.pptx");
auto transition = presentation->get_Slide(0)->get_SlideShowTransition();
transition->set_Type(TransitionType::Cut);

auto cutTransition = AsCast<IOptionalBlackTransition>(transition->get_Value());
if (cutTransition != nullptr)
{
    cutTransition->set_FromBlack(true);
    presentation->Save(u"cut-from-black.pptx", SaveFormat::Pptx);
}
else
{
    Console::WriteLine(u"Cut transition options are unavailable.");
}

presentation->Dispose();

常見問題

我可以控制投影片轉場的播放速度嗎？

可以。當您需要以毫秒為單位的精確效果持續時間時，請優先使用 set_Duration。若預先定義的 TransitionSpeed（Slow、Medium 或 Fast）已足夠且未設定明確持續時間，則使用 set_Speed。這些設定會獨立於自動前進的延遲時間，僅控制轉場效果本身。

我可以在轉場上附加音訊並讓其循環播放嗎？

可以。使用 set_Sound 指定內嵌音訊，呼叫 set_SoundMode 並傳入來自 TransitionSoundMode 列舉的 StartSound，再以 set_SoundLoop 啟用循環。音訊會持續循環直至投影片放映中的下一個音效事件。

將相同的轉場套用至每張投影片的最快方式是什麼？

遍歷簡報的 get_Slides 方法返回的集合，對每張投影片的轉場呼叫 set_Type 並傳入相同的值。在同一迴圈中設定計時與效果選項，以確保所有投影片的行為一致。

我如何檢查投影片目前設定的轉場類型？

對投影片的 get_SlideShowTransition 方法返回的轉場呼叫 get_Type。它會返回來自 TransitionType 列舉的值；None 表示未套用任何轉場效果。

在 C++ 中變更簡報投影片大小在 C++ 中管理簡報的繪圖參考線