จัดการกล่องข้อความในงานนำเสนอโดยใช้ C++

บทนำ

ข้อความบนสไลด์มักอยู่ในช่องข้อความหรือรูปทรง ดังนั้นเพื่อเพิ่มข้อความลงในสไลด์ คุณต้องเพิ่มช่องข้อความแล้วใส่ข้อความบางส่วนลงในช่องนั้น Aspose.Slides for C++ มีอินเทอร์เฟซ IAutoShape ที่ช่วยให้คุณเพิ่มรูปทรงที่มีข้อความได้

Info

Aspose.Slides ยังมีอินเทอร์เฟซ IShape ที่ช่วยให้คุณเพิ่มรูปทรงลงในสไลด์ อย่างไรก็ตาม รูปทรงทั้งหมดที่เพิ่มผ่านอินเทอร์เฟซ IShape ไม่สามารถเก็บข้อความได้ แต่รูปทรงที่เพิ่มผ่านอินเทอร์เฟซ IAutoShape อาจมีข้อความได้

Note

ดังนั้นเมื่อทำงานกับรูปทรงที่ต้องการเพิ่มข้อความ คุณควรตรวจสอบและยืนยันว่ามันถูกแคสผ่านอินเทอร์เฟซ IAutoShape เท่านั้น จึงจะสามารถทำงานกับ TextFrame ซึ่งเป็นคุณสมบัติของ IAutoShape ดูส่วน Update Text ในหน้า นี้

สร้างช่องข้อความบนสไลด์

เพื่อต้องการสร้างช่องข้อความบนสไลด์ ทำตามขั้นตอนต่อไปนี้:

สร้างอินสแตนซ์ของคลาส Presentation
รับอ้างอิงของสไลด์แรกในงานนำเสนอใหม่ที่สร้างขึ้น
เพิ่มวัตถุ IAutoShape โดยตั้งค่า ShapeType เป็น Rectangle ที่ตำแหน่งที่ระบุบนสไลด์และรับอ้างอิงของวัตถุ IAutoShape ที่เพิ่มใหม่
เพิ่มคุณสมบัติ TextFrame ให้กับวัตถุ IAutoShape ที่จะบรรจุข้อความ ในตัวอย่างด้านล่าง เราได้เพิ่มข้อความนี้: Aspose TextBox
สุดท้ายให้เขียนไฟล์ PPTX ผ่านวัตถุ Presentation

โค้ด C++ ที่เป็นการลงมือทำตามขั้นตอนด้านบนแสดงวิธีเพิ่มข้อความลงในสไลด์:

// สร้างอินสแตนซ์ Presentation
auto pres = System::MakeObject<Presentation>();

// ดึงสไลด์แรกในงานนำเสนอ
auto sld = pres->get_Slides()->idx_get(0);

// เพิ่ม AutoShape โดยกำหนดประเภทเป็น Rectangle
auto ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150.0f, 75.0f, 150.0f, 50.0f);

// เพิ่ม TextFrame ให้กับ Rectangle
ashp->AddTextFrame(u" ");

// เข้าถึง Text Frame
auto txtFrame = ashp->get_TextFrame();

// สร้างอ็อบเจกต์ Paragraph สำหรับ Text Frame
auto para = txtFrame->get_Paragraphs()->idx_get(0);

// สร้างอ็อบเจกต์ Portion สำหรับ Paragraph
auto portion = para->get_Portions()->idx_get(0);

// ตั้งค่า Text
portion->set_Text(u"Aspose TextBox");

// บันทึกงานนำเสนอลงดิสก์
pres->Save(u"TextBox_out.pptx", SaveFormat::Pptx);

ตรวจสอบรูปทรงประเภทช่องข้อความ

Aspose.Slides มีเมธอด get_IsTextBox จากอินเทอร์เฟซ IAutoShape ที่ช่วยให้คุณตรวจสอบรูปทรงและระบุว่าเป็นช่องข้อความหรือไม่

กล่องข้อความและรูปทรง

โค้ด 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();

หมายเหตุว่า หากคุณเพียงเพิ่มออโตช์เพมโดยใชเมธอด AddAutoShape จากอินเทอร์เฟซ IShapeCollection เมธอด 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);

// เพิ่ม TextFrame ให้กับ Rectangle
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);

เพิ่มคอลัมน์ให้กับ Text Frame

Aspose.Slides for C++ มีเมธอด set_ColumnCount (จากอินเทอร์เฟซ ITextFrameFormat) ที่ช่วยให้คุณเพิ่มคอลัมน์ใน Text Frame ผ่านเมธอดนี้ คุณสามารถระบุตัวเลขคอลัมน์ที่ต้องการใน Text Frame ได้

โค้ด C++ นี้แสดงวิธีเพิ่มคอลัมน์ภายใน Text Frame:

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 ที่เพิ่มใหม่
เพิ่ม TextFrame ให้กับวัตถุ AutoShape ที่มีข้อความเริ่มต้นเป็น Aspose TextBox
สร้างอินสแตนซ์ของคลาส IHyperlinkManager
กำหนดวัตถุ IHyperlinkManager ให้กับเมธอด set_HyperlinkClick ที่เชื่อมกับส่วนที่ต้องการของ TextFrame
สุดท้ายให้เขียนไฟล์ PPTX ผ่านวัตถุ Presentation

โค้ด C++ นี้—การลงมือทำตามขั้นตอนข้างต้น—แสดงวิธีเพิ่มช่องข้อความพร้อมไฮเปอร์ลิงก์ลงในสไลด์:

// สร้างอินสแตนซ์ของคลาส Presentation ที่เป็นตัวแทนของไฟล์ PPTX
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);

// เข้าถึงคุณสมบัติ ITextFrame ที่เชื่อมกับ AutoShape
autoShape->AddTextFrame(u"");

auto textFrame = autoShape->get_TextFrame();

// เพิ่มข้อความบางส่วนลงในเฟรม
textFrame->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)->set_Text(u"Aspose.Slides");

// ตั้งค่า Hyperlink สำหรับข้อความส่วน
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

ความแตกต่างระหว่างช่องข้อความกับตัวจัดตำแหน่งข้อความเมื่อทำงานกับสไลด์แม่คืออะไร?

placeholder สืบทอดสไตล์/ตำแหน่งจาก master และสามารถถูกเปลี่ยนแปลงใน layouts ได้ ในขณะที่ช่องข้อความปกติเป็นออบเจกต์อิสระบนสไลด์เฉพาะและไม่เปลี่ยนแปลงเมื่อสลับเลย์เอาต์

จะทำการแทนที่ข้อความจำนวนมากทั่วทั้งงานนำเสนอโดยไม่กระทบข้อความในแผนภูมิ ตาราง หรือ SmartArt อย่างไร?

จำกัดการวนลูปให้กับออโตช์เพมที่มี TextFrame และละเว้นออบเจกต์ที่ฝังอยู่ (charts, tables, SmartArt) โดยแยกคอลเลกชันเหล่านี้ออกจากกันหรือข้ามประเภทออบเจกต์ดังกล่าว

จัดการ Placeholder ของพรีเซนเทชันใน C++ เพิ่มประสิทธิภาพการนำเสนอของคุณด้วย AutoFit ใน C++