C++ kullanarak Sunumlarda Metin Kutularını Yönetme

Giriş

Slaytlardaki metinler genellikle metin kutularında veya şekillerde bulunur. Bu nedenle, bir slayta metin eklemek için bir metin kutusu eklemeniz ve ardından metni metin kutusunun içine koymanız gerekir. Aspose.Slides for C++ IAutoShape arayüzünü sağlar; bu arayüz, içinde metin bulunan bir şekil eklemenize izin verir.

Info

Aspose.Slides ayrıca slaytlara şekil eklemenizi sağlayan IShape arayüzünü de sağlar. Ancak, IShape arayüzü aracılığıyla eklenen tüm şekiller metin tutamaz. Fakat IAutoShape arayüzü aracılığıyla eklenen şekiller metin içerebilir.

Note

Bu nedenle, metin eklemek istediğiniz bir şekille çalışırken, şeklin IAutoShape arayüzü üzerinden dönüştürülüp dönüştürülmediğini kontrol etmek ve doğrulamak isteyebilirsiniz. Ancak o zaman IAutoShape altında bir özellik olan TextFrame ile çalışabilirsiniz. Bu sayfadaki Update Text bölümüne bakın.

Bir Slaytta Metin Kutusu Oluşturma

Bir slaytta metin kutusu oluşturmak için bu adımları izleyin:

Yeni bir Presentation sınıfının bir örneğini oluşturun.
Yeni oluşturulan sunumdaki ilk slayt için bir referans alın.
Slayt üzerinde belirli bir konumda Rectangle olarak ayarlanmış ShapeType ile bir IAutoShape nesnesi ekleyin ve yeni eklenen IAutoShape nesnesinin referansını alın.
IAutoShape nesnesine metin içerecek bir TextFrame özelliği ekleyin. Aşağıdaki örnekte bu metni ekledik: Aspose TextBox
Son olarak, PPTX dosyasını Presentation nesnesi aracılığıyla yazın.

Bu C++ kodu—yukarıdaki adımların bir uygulaması—bir slayta metin eklemenin nasıl yapılacağını gösterir:

// Sunumu örnekler
auto pres = System::MakeObject<Presentation>();

// Sunumdaki ilk slaytı alır
auto sld = pres->get_Slides()->idx_get(0);

// Türü Rectangle olarak ayarlanmış bir AutoShape ekler
auto ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150.0f, 75.0f, 150.0f, 50.0f);

// Rectangle'a TextFrame ekler
ashp->AddTextFrame(u" ");

// Metin çerçevesine erişir
auto txtFrame = ashp->get_TextFrame();

// Metin çerçevesi için Paragraph nesnesi oluşturur
auto para = txtFrame->get_Paragraphs()->idx_get(0);

// Paragraf için Portion nesnesi oluşturur
auto portion = para->get_Portions()->idx_get(0);

// Metni ayarlar
portion->set_Text(u"Aspose TextBox");

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

Metin Kutusu Şeklini Kontrol Etme

Aspose.Slides, şekilleri incelemenize ve metin kutularını tanımlamanıza olanak tanıyan IAutoShape arayüzünden get_IsTextBox yöntemini sağlar.

Text box and shape

Bu C++ kodu, bir şeklin metin kutusu olarak oluşturulup oluşturulmadığını nasıl kontrol edeceğinizi gösterir:

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

Şunu not edin: IShapeCollection arayüzündeki AddAutoShape yöntemiyle yalnızca bir otos şekil eklediğinizde, otos şeklinin get_IsTextBox yöntemi false dönecektir. Ancak, otos şekle AddTextFrame yöntemi ya da set_Text yöntemiyle metin ekledikten sonra, get_IsTextBox yöntemi true döner.

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 döndürür
shape1->AddTextFrame(u"shape 1");
// shape1->get_IsTextBox() true döndürür

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

auto shape3 = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 10, 210, 100, 40);
// shape3->get_IsTextBox() false döndürür
shape3->AddTextFrame(u"");
// shape3->get_IsTextBox() false döndürür

auto shape4 = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 10, 310, 100, 40);
// shape4->get_IsTextBox() false döndürür
shape4->get_TextFrame()->set_Text(u"");
// shape4->get_IsTextBox() false döndürür

Metin Kutusuna Sütunlar Ekleme

Aspose.Slides, metin kutularına sütun eklemenizi sağlayan set_ColumnCount ve set_ColumnSpacing yöntemlerini (ITextFrameFormat arayüzünden ve TextFrameFormat sınıfından) sunar. Metin kutusundaki sütun sayısını belirleyebilir ve sütunlar arasındaki boşluğu puan cinsinden ayarlayabilirsiniz.

Bu C++ kodu, açıklanan işlemi göstermektedir:

auto presentation = System::MakeObject<Presentation>();
// Sunumdaki ilk slaytı alır
auto slide = presentation->get_Slides()->idx_get(0);

// Türü Rectangle olarak ayarlanmış bir AutoShape ekle
auto aShape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 300.0f, 300.0f);

// Rectangle'a TextFrame ekle
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'in metin biçimini alır
auto format = aShape->get_TextFrame()->get_TextFrameFormat();

// TextFrame içindeki sütun sayısını belirtir
format->set_ColumnCount(3);

// Sütunlar arasındaki boşluğu belirler
format->set_ColumnSpacing(10);

// Sunumu kaydeder
presentation->Save(u"ColumnCount.pptx", SaveFormat::Pptx);

Metin Çerçevesine Sütunlar Ekleme

Aspose.Slides for C++, metin çerçevelerine sütun eklemenizi sağlayan set_ColumnCount yöntemini (ITextFrameFormat arayüzünden) sunar. Bu yöntemle, bir metin çerçevesindeki tercih edilen sütun sayısını belirtebilirsiniz.

Bu C++ kodu, bir metin çerçevesi içinde sütun eklemenin nasıl yapılacağını gösterir:

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());
}

Metni Güncelleme

Aspose.Slides, bir metin kutusundaki veya bir sunumdaki tüm metinleri değiştirme veya güncelleme imkanı sağlar.

Bu C++ kodu, bir sunumdaki tüm metinlerin güncellendiği veya değiştirildiği bir işlemi gösterir:

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())
                {
                    //Metni değiştirir
                    portion->set_Text(portion->get_Text().Replace(u"years", u"months"));
                    //Biçimlendirmeyi değiştirir
                    portion->get_PortionFormat()->set_FontBold(NullableBool::True);
                }
            }
        }
    }
}

//Değiştirilmiş sunumu kaydeder
pres->Save(u"text-changed.pptx", SaveFormat::Pptx);

Köprü İçeren Metin Kutusu Ekleme

Bir metin kutusunun içine bir bağlantı ekleyebilirsiniz. Metin kutusuna tıklandığında, kullanıcılar bağlantıyı açmak için yönlendirilir.

Köprü içeren bir metin kutusu eklemek için bu adımları izleyin:

Presentation sınıfının bir örneğini oluşturun.
Yeni oluşturulan sunumda ilk slayt için bir referans alın.
ShapeType Rectangle olarak ayarlanmış bir AutoShape nesnesi ekleyin ve yeni eklenen AutoShape nesnesinin referansını alın.
AutoShape nesnesine varsayılan metni Aspose TextBox olan bir TextFrame ekleyin.
IHyperlinkManager sınıfının bir örneğini oluşturun.
TextFrame‘in istediğiniz kısmına ilişkilendirilmiş set_HyperlinkClick yöntemine IHyperlinkManager nesnesini atayın.
Son olarak, PPTX dosyasını Presentation nesnesi aracılığıyla yazın.

Bu C++ kodu—yukarıdaki adımların bir uygulaması—bir slayta köprü içeren bir metin kutusu eklemenin nasıl yapılacağını gösterir:

// PPTX'i temsil eden bir Presentation sınıfı örnekler
auto presentation = System::MakeObject<Presentation>();

// Sunumdaki ilk slaytı alır
auto slide = presentation->get_Slides()->idx_get(0);

// Türü Rectangle olarak ayarlanmış bir AutoShape nesnesi ekler
auto shape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150.0f, 150.0f, 150.0f, 50.0f);

// Şekli AutoShape olarak dönüştürür
auto autoShape = System::ExplicitCast<IAutoShape>(shape);

// AutoShape ile ilişkili ITextFrame özelliğine erişir
autoShape->AddTextFrame(u"");

auto textFrame = autoShape->get_TextFrame();

// Çerçeveye bazı metinler ekler
textFrame->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)->set_Text(u"Aspose.Slides");

// Bölüm metni için Köprüyü ayarlar
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 Sunumunu kaydeder
presentation->Save(u"hLinkPPTX_out.pptx", SaveFormat::Pptx);

FAQ

Master slaytlarla çalışırken bir metin kutusu ile metin yer tutucu arasındaki fark nedir?

Bir placeholder, master stilini/konumunu devralır ve layouts üzerinde geçersiz kılınabilir, oysa normal bir metin kutusu belirli bir slaytta bağımsız bir nesnedir ve düzenleri değiştirdiğinizde değişmez.

Grafikler, tablolar ve SmartArt içindeki metinlere dokunmadan tüm sunumda toplu metin değiştirme nasıl yapabilirim?

Yinelemeyi, metin çerçevelerine sahip otos-şekillere sınırlayın ve gömülü nesneleri (charts, tables, SmartArt) ayrı ayrı koleksiyonlarını gezerek veya bu nesne türlerini atlayarak dışarıda bırakın.

C++'ta Sunum Yer Tutucularını Yönetin C++'ta AutoFit ile Sunumlarınızı Geliştirin