Mengelola Kotak Teks dalam Presentasi di .NET

Pendahuluan

Teks pada slide biasanya berada dalam kotak teks atau bentuk. Oleh karena itu, untuk menambahkan teks ke slide, Anda harus menambahkan kotak teks terlebih dahulu lalu menaruh teks di dalam kotak teks.

Untuk memungkinkan Anda menambahkan bentuk yang dapat menampung teks, Aspose.Slides untuk .NET menyediakan antarmuka IAutoShape.

Note

Aspose.Slides juga menyediakan antarmuka IShape untuk memungkinkan Anda menambahkan bentuk ke slide. Namun, tidak semua bentuk yang ditambahkan melalui antarmuka IShape dapat menampung teks. Bentuk yang ditambahkan melalui antarmuka IAutoShape biasanya berisi teks.

Oleh karena itu, ketika menangani bentuk yang sudah ada dan ingin Anda tambahkan teks, Anda mungkin ingin memeriksa dan memastikan bahwa bentuk tersebut telah di‑cast melalui antarmuka IAutoShape. Hanya dengan begitu Anda dapat bekerja dengan TextFrame, yang merupakan properti di bawah IAutoShape. Lihat bagian Update Text pada halaman ini.

Buat Kotak Teks pada Slide

Buat instance dari kelas Presentation.
Dapatkan referensi slide pertama melalui indeksnya.
Tambahkan objek IAutoShape dengan ShapeType diatur ke Rectangle pada posisi tertentu di slide dan dapatkan referensi untuk objek IAutoShape yang baru ditambahkan.
Tambahkan properti TextFrame ke objek IAutoShape yang akan berisi teks. Pada contoh di bawah, kami menambahkan teks ini: Aspose TextBox
Terakhir, tulis file PPTX melalui objek Presentation.

Kode C# ini—implementasi langkah-langkah di atas—menunjukkan cara menambahkan teks ke slide:

// Membuat instance Presentation
using (Presentation pres = new Presentation())
{

    // Mendapatkan slide pertama dalam presentasi
    ISlide sld = pres.Slides[0];

    // Menambahkan AutoShape dengan tipe diatur sebagai Rectangle
    IAutoShape ashp = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 150, 75, 150, 50);

    // Menambahkan TextFrame ke Rectangle
    ashp.AddTextFrame(" ");

    // Mengakses text frame
    ITextFrame txtFrame = ashp.TextFrame;

    // Membuat objek Paragraph untuk text frame
    IParagraph para = txtFrame.Paragraphs[0];

    // Membuat objek Portion untuk paragraf
    IPortion portion = para.Portions[0];

    // Menetapkan teks
    portion.Text = "Aspose TextBox";

    // Menyimpan presentasi ke disk
    pres.Save("TextBox_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

Periksa Bentuk Kotak Teks

Aspose.Slides menyediakan properti IsTextBox dari antarmuka IAutoShape , yang memungkinkan Anda memeriksa bentuk dan mengidentifikasi kotak teks.

Kotak teks dan bentuk

Kode C# ini menunjukkan cara memeriksa apakah sebuah bentuk dibuat sebagai kotak teks:

using (Presentation presentation = new Presentation("sample.pptx"))
{
    Aspose.Slides.LowCode.ForEach.Shape(presentation, (shape, slide, index) =>
    {
        if (shape is IAutoShape autoShape)
        {
            Console.WriteLine(autoShape.IsTextBox ? "shape is a text box" : "shape is not a text box");
        }
    });
}

Catatan bahwa jika Anda hanya menambahkan autoshape menggunakan metode AddAutoShape dari antarmuka IShapeCollection, properti IsTextBox pada autoshape akan mengembalikan false. Namun, setelah Anda menambahkan teks ke autoshape menggunakan metode AddTextFrame atau properti Text, properti IsTextBox akan mengembalikan true.

using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    IAutoShape shape1 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 40);
    // shape1.IsTextBox adalah false
    shape1.AddTextFrame("shape 1");
    // shape1.IsTextBox adalah true

    IAutoShape shape2 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 110, 100, 40);
    // shape2.IsTextBox adalah false
    shape2.TextFrame.Text = "shape 2";
    // shape2.IsTextBox adalah true

    IAutoShape shape3 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 210, 100, 40);
    // shape3.IsTextBox adalah false
    shape3.AddTextFrame("");
    // shape3.IsTextBox adalah false

    IAutoShape shape4 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 310, 100, 40);
    // shape4.IsTextBox adalah false
    shape4.TextFrame.Text = "";
    // shape4.IsTextBox adalah false
}

Tambahkan Kolom ke Kotak Teks

Aspose.Slides menyediakan properti ColumnCount dan ColumnSpacing (dari antarmuka ITextFrameFormat dan kelas TextFrameFormat) untuk memungkinkan Anda menambahkan kolom ke kotak teks. Anda dapat menentukan jumlah kolom dalam kotak teks dan kemudian menentukan jarak antar kolom dalam poin.

Kode ini dalam C# mendemonstrasikan operasi yang dijelaskan:

using (Presentation presentation = new Presentation())
{
	// Mendapatkan slide pertama dalam presentasi
	ISlide slide = presentation.Slides[0];

	// Menambahkan AutoShape dengan tipe diatur sebagai Rectangle
	IAutoShape aShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);

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

	// Mendapatkan format teks dari TextFrame
	ITextFrameFormat format = aShape.TextFrame.TextFrameFormat;

	// Menentukan jumlah kolom dalam TextFrame
	format.ColumnCount = 3;

	// Menentukan jarak antar kolom
	format.ColumnSpacing = 10;

	// Menyimpan presentasi
	presentation.Save("ColumnCount.pptx", SaveFormat.Pptx);
}

Tambahkan Kolom ke Bingkai Teks

Aspose.Slides untuk .NET menyediakan properti ColumnCount (dari antarmuka ITextFrameFormat) yang memungkinkan Anda menambahkan kolom dalam bingkai teks. Melalui properti ini, Anda dapat menentukan jumlah kolom yang diinginkan dalam sebuah bingkai teks.

Kode C# ini menunjukkan cara menambahkan kolom di dalam bingkai teks:

string outPptxFileName = "ColumnsTest.pptx";
using (Presentation pres = new Presentation())
{
    IAutoShape shape1 = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);
    TextFrameFormat format = (TextFrameFormat)shape1.TextFrame.TextFrameFormat;

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

    using (Presentation test = new Presentation(outPptxFileName))
    {
        Debug.Assert(2 == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnCount);
        Debug.Assert(double.NaN == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnSpacing);
    }

    format.ColumnSpacing = 20;
    pres.Save(outPptxFileName, SaveFormat.Pptx);

    using (Presentation test = new Presentation(outPptxFileName))
    {
        Debug.Assert(2 == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnCount);
        Debug.Assert(20 == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnSpacing);
    }

    format.ColumnCount = 3;
    format.ColumnSpacing = 15;
    pres.Save(outPptxFileName, SaveFormat.Pptx);

    using (Presentation test = new Presentation(outPptxFileName))
    {
        Debug.Assert(3 == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnCount);
        Debug.Assert(15 == ((AutoShape)test.Slides[0].Shapes[0]).TextFrame.TextFrameFormat.ColumnSpacing);
    }
}

Perbarui Teks

Aspose.Slides memungkinkan Anda mengubah atau memperbarui teks yang terdapat dalam kotak teks atau semua teks yang terdapat dalam presentasi.

Kode C# ini mendemonstrasikan operasi di mana semua teks dalam presentasi diperbarui atau diubah:

using(Presentation pres = new Presentation("text.pptx"))
{
   foreach (ISlide slide in pres.Slides)
   {
       foreach (IShape shape in slide.Shapes)
       {
           if (shape is IAutoShape autoShape) //Memeriksa apakah shape mendukung text frame (IAutoShape). 
           {
              foreach (IParagraph paragraph in autoShape.TextFrame.Paragraphs) //Iterasi melalui paragraf dalam text frame
               {
                   foreach (IPortion portion in paragraph.Portions) //Iterasi melalui setiap portion dalam paragraf
                   {
                       portion.Text = portion.Text.Replace("years", "months"); //Mengubah teks
                       portion.PortionFormat.FontBold = NullableBool.True; //Mengubah format
                   }
               }
           }
       }
   }
  
   //Menyimpan presentasi yang telah dimodifikasi
   pres.Save("text-changed.pptx", SaveFormat.Pptx);
}

Tambahkan Kotak Teks dengan Hyperlink

Anda dapat menyisipkan tautan di dalam kotak teks. Ketika kotak teks diklik, pengguna akan diarahkan untuk membuka tautan tersebut.

Buat instance dari kelas Presentation.
Dapatkan referensi slide pertama melalui indeksnya.
Tambahkan objek AutoShape dengan ShapeType diatur ke Rectangle pada posisi tertentu di slide dan dapatkan referensi objek AutoShape yang baru ditambahkan.
Tambahkan TextFrame ke objek AutoShape yang berisi Aspose TextBox sebagai teks defaultnya.
Buat instance kelas IHyperlinkManager.
Tetapkan objek IHyperlinkManager ke properti HyperlinkClick yang terkait dengan bagian TextFrame yang Anda inginkan.
Terakhir, tulis file PPTX melalui objek Presentation.

Kode C# ini—implementasi langkah-langkah di atas—menunjukkan cara menambahkan kotak teks dengan hyperlink ke slide:

// Membuat instance kelas Presentation yang mewakili sebuah PPTX
// Mendapatkan slide pertama dalam presentasi
// Menambahkan objek AutoShape dengan tipe diatur sebagai Rectangle
// Meng-cast shape menjadi AutoShape
// Mengakses properti ITextFrame yang terkait dengan AutoShape
// Menambahkan beberapa teks ke frame
// Menetapkan Hyperlink untuk teks portion
// Menyimpan Presentasi PPTX
Presentation pptxPresentation = new Presentation();

// Gets the first slide in the presentation
ISlide slide = pptxPresentation.Slides[0];

// Adds an AutoShape object with type set as Rectangle
IShape pptxShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 150, 150, 150, 50);

// Casts the shape to AutoShape
IAutoShape pptxAutoShape = (IAutoShape)pptxShape;

// Accesses the ITextFrame property associated with the AutoShape
pptxAutoShape.AddTextFrame("");

ITextFrame ITextFrame = pptxAutoShape.TextFrame;

// Adds some text to the frame
ITextFrame.Paragraphs[0].Portions[0].Text = "Aspose.Slides";

// Sets the Hyperlink for the portion text
IHyperlinkManager HypMan = ITextFrame.Paragraphs[0].Portions[0].PortionFormat.HyperlinkManager;
HypMan.SetExternalHyperlinkClick("http://www.aspose.com");

// Saves the PPTX Presentation
pptxPresentation.Save("hLinkPPTX_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);

FAQ

Apa perbedaan antara kotak teks dan placeholder teks saat bekerja dengan master slide?

Sebuah placeholder mewarisi gaya/posisi dari master dan dapat diganti pada layouts, sedangkan kotak teks biasa adalah objek independen pada slide tertentu dan tidak berubah ketika Anda beralih layout.

Bagaimana cara melakukan penggantian teks secara massal di seluruh presentasi tanpa memengaruhi teks di dalam chart, tabel, dan SmartArt?

Batasi iterasi Anda hanya pada auto‑shapes yang memiliki text frame dan kecualikan objek tersemat (charts, tables, SmartArt) dengan menelusuri koleksi mereka secara terpisah atau melewati tipe objek tersebut.

Kelola Placeholder Presentasi di .NET Meningkatkan Presentasi Anda dengan AutoFit di .NET