使用 C++ 管理簡報中的文字方塊

簡介

投影片上的文字通常位於文字方塊或圖形中。因此，要在投影片上加入文字，必須先新增文字方塊，然後在文字方塊中放入文字。Aspose.Slides for C++ 提供了 IAutoShape 介面，允許您新增包含文字的圖形。

Info

Aspose.Slides 也提供了 IShape 介面，允許您向投影片新增圖形。但是，透過 IShape 介面新增的所有圖形並不一定能容納文字。但透過 IAutoShape 介面新增的圖形可能包含文字。

Note

因此，當處理想要加入文字的圖形時，您可能需要檢查並確認它是透過 IAutoShape 介面轉型的。只有這樣才能使用 IAutoShape 下的屬性 TextFrame。請參閱本頁面的 Update Text 章節。

在投影片上建立文字方塊

要在投影片上建立文字方塊，請遵循以下步驟：

建立 Presentation 類別的實例。
取得新建立的簡報中第一張投影片的參考。
在投影片上指定位置新增一個 IAutoShape 物件，將 ShapeType 設為 Rectangle，並取得新新增的 IAutoShape 物件的參考。
為 IAutoShape 物件新增 TextFrame 屬性以容納文字。在下例中，我們加入的文字為：Aspose TextBox
最後，透過 Presentation 物件寫入 PPTX 檔案。

以下 C++ 程式碼—上述步驟的實作範例—示範如何在投影片中加入文字：

// 實例化 Presentation
// 取得簡報中的第一張投影片
// 新增 AutoShape，類型設定為 Rectangle
// 為 Rectangle 新增 TextFrame
// 取得文字框架
// 為文字框架建立 Paragraph 物件
// 為段落建立 Portion 物件
// 設定文字
// 將簡報儲存到磁碟
auto pres = System::MakeObject<Presentation>();

auto sld = pres->get_Slides()->idx_get(0);

auto ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150.0f, 75.0f, 150.0f, 50.0f);

ashp->AddTextFrame(u" ");

auto txtFrame = ashp->get_TextFrame();

auto para = txtFrame->get_Paragraphs()->idx_get(0);

auto portion = para->get_Portions()->idx_get(0);

portion->set_Text(u"Aspose TextBox");

pres->Save(u"TextBox_out.pptx", SaveFormat::Pptx);

檢查文字方塊圖形

Aspose.Slides 從 IAutoShape 介面提供 get_IsTextBox 方法，讓您檢查圖形並辨識文字方塊。

Text box and shape

以下 C++ 程式碼示範如何檢查圖形是否是文字方塊：

auto presentation = MakeObject<Presentation>(u"sample.pptx");
for (auto&& slide : presentation->get_Slides())
{
    for (auto&& shape : slide->get_Shapes())
    {
        if (ObjectExt::Is<IAutoShape>(shape))
        {
            auto autoShape = ExplicitCast<IAutoShape>(shape);
            Console::WriteLine(autoShape->get_IsTextBox() ? u"shape is a text box" : u"shape is not a text box");
        }
    }
}

presentation->Dispose();

請注意，如果僅使用 IShapeCollection 介面的 AddAutoShape 方法新增自動圖形，該自動圖形的 get_IsTextBox 方法將返回 false。但在使用 AddTextFrame 方法或 set_Text 方法為自動圖形加入文字後，get_IsTextBox 方法會返回 true。

auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);

auto shape1 = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 10, 10, 100, 40);
// shape1->get_IsTextBox() 傳回 false
shape1->AddTextFrame(u"shape 1");
// shape1->get_IsTextBox() 傳回 true

auto shape2 = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 10, 110, 100, 40);
// shape2->get_IsTextBox() 傳回 false
shape2->get_TextFrame()->set_Text(u"shape 2");
// shape2->get_IsTextBox() 傳回 true

auto shape3 = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 10, 210, 100, 40);
// shape3->get_IsTextBox() 傳回 false
shape3->AddTextFrame(u"");
// shape3->get_IsTextBox() 傳回 false

auto shape4 = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 10, 310, 100, 40);
// shape4->get_IsTextBox() 傳回 false
shape4->get_TextFrame()->set_Text(u"");
// shape4->get_IsTextBox() 傳回 false

在文字方塊中添加欄

Aspose.Slides 提供 set_ColumnCount 與 set_ColumnSpacing 方法（分別來自 ITextFrameFormat 介面與 TextFrameFormat 類別），允許您在文字方塊中加入欄。您可以指定文字方塊的欄數，並以點為單位設定欄與欄之間的間距。

以下 C++ 程式碼示範上述操作：

auto presentation = System::MakeObject<Presentation>();
// 取得簡報中的第一張投影片
auto slide = presentation->get_Slides()->idx_get(0);

// 新增 AutoShape，類型設定為 Rectangle
auto aShape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 300.0f, 300.0f);

// 為 Rectangle 新增 TextFrame
aShape->AddTextFrame(String(u"All these columns are limited to be within a single text container -- ") 
    + u"you can add or delete text and the new or remaining text automatically adjusts " 
    + u"itself to flow within the container. You cannot have text flow from one container " 
    + u"to other though -- we told you PowerPoint's column options for text are limited!");

// 取得 TextFrame 的文字格式
auto format = aShape->get_TextFrame()->get_TextFrameFormat();

// 指定 TextFrame 中的欄數
format->set_ColumnCount(3);

// 指定欄與欄之間的間距
format->set_ColumnSpacing(10);

// 儲存簡報
presentation->Save(u"ColumnCount.pptx", SaveFormat::Pptx);

在文字框架中添加欄

Aspose.Slides for C++ 提供 set_ColumnCount 方法（來自 ITextFrameFormat 介面），允許您在文字框架中加入欄。透過此方法，您可以指定文字框架的欄數。

以下 C++ 程式碼示範如何在文字框架中加入欄：

String outPptxFileName = u"ColumnsTest.pptx";
    
auto pres = System::MakeObject<Presentation>();
auto shape = pres->get_Slides()->idx_get(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 300.0f, 300.0f);
auto format = System::ExplicitCast<TextFrameFormat>(shape->get_TextFrame()->get_TextFrameFormat());

format->set_ColumnCount(2);
shape->get_TextFrame()->set_Text(String(u"All these columns are forced to stay within a single text container -- ") 
    + u"you can add or delete text - and the new or remaining text automatically adjusts " 
    + u"itself to stay within the container. You cannot have text spill over from one container " 
    + u"to other, though -- because PowerPoint's column options for text are limited!");
pres->Save(outPptxFileName, SaveFormat::Pptx);

{
    auto test = System::MakeObject<Presentation>(outPptxFileName);
    auto format1 = System::ExplicitCast<AutoShape>(test->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0))->get_TextFrame()->get_TextFrameFormat();
    CODEPORTING_DEBUG_ASSERT1(2 == format1->get_ColumnCount());
    CODEPORTING_DEBUG_ASSERT1(std::numeric_limits<double>::quiet_NaN() == format1->get_ColumnSpacing());
}

format->set_ColumnSpacing(20);
pres->Save(outPptxFileName, SaveFormat::Pptx);

{
    auto test = System::MakeObject<Presentation>(outPptxFileName);
    auto format2 = System::ExplicitCast<AutoShape>(test->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0))->get_TextFrame()->get_TextFrameFormat();
    CODEPORTING_DEBUG_ASSERT1(2 == format2->get_ColumnCount());
    CODEPORTING_DEBUG_ASSERT1(20 == format2->get_ColumnSpacing());
}

format->set_ColumnCount(3);
format->set_ColumnSpacing(15);
pres->Save(outPptxFileName, SaveFormat::Pptx);

{
    auto test = System::MakeObject<Presentation>(outPptxFileName);
    auto format3 = System::ExplicitCast<AutoShape>(test->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0))->get_TextFrame()->get_TextFrameFormat();
    CODEPORTING_DEBUG_ASSERT1(3 == format3->get_ColumnCount());
    CODEPORTING_DEBUG_ASSERT1(15 == format3->get_ColumnSpacing());
}

更新文字

Aspose.Slides 允許您變更或更新文字方塊中的文字，或更新簡報中所有的文字。

以下 C++ 程式碼示範將簡報中所有文字更新或變更的操作：

auto pres = System::MakeObject<Presentation>(u"text.pptx");
for (const auto& slide : pres->get_Slides())
{
    for (const auto& shape : slide->get_Shapes())
    {
        if (ObjectExt::Is<IAutoShape>(shape))
        {
            auto autoShape = System::AsCast<IAutoShape>(shape);
            for (const auto& paragraph : autoShape->get_TextFrame()->get_Paragraphs())
            {
                for (const auto& portion : paragraph->get_Portions())
                {
                    //變更文字
                    portion->set_Text(portion->get_Text().Replace(u"years", u"months"));
                    //變更格式
                    portion->get_PortionFormat()->set_FontBold(NullableBool::True);
                }
            }
        }
    }
}

//儲存已修改的簡報
pres->Save(u"text-changed.pptx", SaveFormat::Pptx);

新增帶有超連結的文字方塊

您可以在文字方塊中插入連結。當使用者點擊文字方塊時，會開啟該連結。

要新增包含連結的文字方塊，請遵循以下步驟：

建立 Presentation 類別的實例。
取得新建立的簡報中第一張投影片的參考。
在投影片上指定位置新增一個 AutoShape 物件，將 ShapeType 設為 Rectangle，並取得新新增的 AutoShape 物件的參考。
為 AutoShape 物件新增 TextFrame，其預設文字為 Aspose TextBox。
建立 IHyperlinkManager 類別的實例。
將 IHyperlinkManager 物件指派給 TextFrame 中您想要的文字區段所對應的 set_HyperlinkClick 方法。
最後，透過 Presentation 物件寫入 PPTX 檔案。

以下 C++ 程式碼—上述步驟的實作範例—示範如何在投影片中新增帶有超連結的文字方塊：

// 實例化表示 PPTX 的 Presentation 類別
auto presentation = System::MakeObject<Presentation>();

// 取得簡報中的第一張投影片
auto slide = presentation->get_Slides()->idx_get(0);

// 新增 AutoShape 物件，類型設定為 Rectangle
auto shape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150.0f, 150.0f, 150.0f, 50.0f);

// 將圖形轉型為 AutoShape
auto autoShape = System::ExplicitCast<IAutoShape>(shape);

// 存取與 AutoShape 相關聯的 ITextFrame 屬性
autoShape->AddTextFrame(u"");

auto textFrame = autoShape->get_TextFrame();

// 為框架新增文字
textFrame->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)->set_Text(u"Aspose.Slides");

// 設定文字區段的超連結
auto linkManager = textFrame->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)->get_PortionFormat()->get_HyperlinkManager();
linkManager->SetExternalHyperlinkClick(u"http://www.aspose.com");

// 儲存 PPTX 簡報
presentation->Save(u"hLinkPPTX_out.pptx", SaveFormat::Pptx);

FAQ

在使用母片時，文字方塊與文字佔位符有何差異？

佔位符會從母片繼承樣式/位置，且可在版面配置上覆寫；而一般的文字方塊則是特定投影片上的獨立物件，切換版面配置時不會變動。

如何在整份簡報中批次取代文字，同時不影響圖表、表格與 SmartArt 內的文字？

將遍歷限制於具有文字框的自動圖形，並排除嵌入式物件（圖表、表格、SmartArt），可分別遍歷它們的集合或直接跳過這些物件類型。

在 C++ 中管理簡報佔位符使用 C++ 的 AutoFit 來增強您的簡報