Kelola Kotak Teks dalam Presentasi di Android

Pendahuluan

Teks pada slide biasanya berada dalam kotak teks atau bentuk. Karena itu, untuk menambahkan teks ke slide, Anda harus menambahkan kotak teks dan kemudian menempatkan teks di dalam kotak tersebut. Aspose.Slides untuk Android via Java menyediakan antarmuka IAutoShape yang memungkinkan Anda menambahkan bentuk yang berisi teks.

Info

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

Catatan

Oleh karena itu, ketika berurusan dengan sebuah bentuk yang ingin Anda tambahkan teks, Anda mungkin perlu 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

Untuk membuat kotak teks pada slide, ikuti langkah‑langkah berikut:

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

Kode Java ini—implementasi dari langkah‑langkah di atas—menunjukkan cara menambahkan teks ke slide:

// Membuat Instance Presentation
Presentation pres = new Presentation();
try {
    // Mendapatkan slide pertama dalam presentasi
    ISlide sld = pres.getSlides().get_Item(0);

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

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

    // Mengakses text frame
    ITextFrame txtFrame = ashp.getTextFrame();

    // Membuat objek Paragraph untuk text frame
    IParagraph para = txtFrame.getParagraphs().get_Item(0);

    // Membuat objek Portion untuk paragraph
    IPortion portion = para.getPortions().get_Item(0);

    // Mengatur Teks
    portion.setText("Aspose TextBox");

    // Menyimpan presentasi ke disk
    pres.save("TextBox_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Periksa Bentuk Kotak Teks

Aspose.Slides menyediakan metode isTextBox dari antarmuka IAutoShape yang memungkinkan Anda memeriksa bentuk dan mengidentifikasi kotak teks.

Kotak teks dan bentuk

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

Presentation presentation = new Presentation("sample.pptx");
try {
    ForEach.shape(presentation, (shape, slide, index) -> {
        if (shape instanceof IAutoShape) {
            IAutoShape autoShape = (IAutoShape) shape;
            System.out.println(autoShape.isTextBox() ? "shape is a text box" : "shape is not a text box");
        }
    });
} finally {
    presentation.dispose();
}

Perhatikan bahwa jika Anda hanya menambahkan sebuah autoshape menggunakan metode addAutoShape dari antarmuka IShapeCollection, metode isTextBox pada autoshape akan mengembalikan false. Namun, setelah Anda menambahkan teks ke autoshape menggunakan metode addTextFrame atau metode setText, properti isTextBox akan mengembalikan true.

Presentation presentation = new Presentation();
ISlide slide = presentation.getSlides().get_Item(0);

IAutoShape shape1 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 100, 40);
// shape1.isTextBox() mengembalikan false
shape1.addTextFrame("shape 1");
// shape1.isTextBox() mengembalikan true

IAutoShape shape2 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 110, 100, 40);
// shape2.isTextBox() mengembalikan false
shape2.getTextFrame().setText("shape 2");
// shape2.isTextBox() mengembalikan true

IAutoShape shape3 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 210, 100, 40);
// shape3.isTextBox() mengembalikan false
shape3.addTextFrame("");
// shape3.isTextBox() mengembalikan false

IAutoShape shape4 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 310, 100, 40);
// shape4.isTextBox() mengembalikan false
shape4.getTextFrame().setText("");
// shape4.isTextBox() mengembalikan false

Tambahkan Kolom ke Kotak Teks

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

Kode Java berikut mendemonstrasikan operasi tersebut:

Presentation pres = new Presentation();
try {
    // Mendapatkan slide pertama dalam presentasi
    ISlide slide = pres.getSlides().get_Item(0);

    // Menambahkan AutoShape dengan tipe diatur sebagai Rectangle
    IAutoShape aShape = slide.getShapes().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.getTextFrame().getTextFrameFormat();

    // Menentukan jumlah kolom dalam TextFrame
    format.setColumnCount(3);

    // Menentukan jarak antar kolom
    format.setColumnSpacing(10);

    // Menyimpan presentasi
    pres.save("ColumnCount.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Tambahkan Kolom ke Text Frame

Aspose.Slides untuk Android via Java menyediakan properti ColumnCount (dari antarmuka ITextFrameFormat) yang memungkinkan Anda menambahkan kolom dalam text frame. Dengan properti ini, Anda dapat menentukan jumlah kolom yang diinginkan dalam sebuah text frame.

Kode Java ini menunjukkan cara menambahkan kolom di dalam text frame:

String outPptxFileName = "ColumnsTest.pptx";
Presentation pres = new Presentation();
try {
    IAutoShape shape1 = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);
    TextFrameFormat format = (TextFrameFormat)shape1.getTextFrame().getTextFrameFormat();

    format.setColumnCount(2);
    shape1.getTextFrame().setText("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);

    Presentation test = new Presentation(outPptxFileName);
    try {
        IAutoShape autoShape = ((AutoShape)test.getSlides().get_Item(0).getShapes().get_Item(0));
        Assert.assertTrue(2 == autoShape.getTextFrame().getTextFrameFormat().getColumnCount());
        Assert.assertTrue(Double.NaN == autoShape.getTextFrame().getTextFrameFormat().getColumnSpacing());
    } finally {
        if (test != null) test.dispose();
    }

    format.setColumnSpacing(20);
    pres.save(outPptxFileName, SaveFormat.Pptx);

    Presentation test1 = new Presentation(outPptxFileName);
    try {
        IAutoShape autoShape = ((AutoShape)test1.getSlides().get_Item(0).getShapes().get_Item(0));
        Assert.assertTrue(2 == autoShape.getTextFrame().getTextFrameFormat().getColumnCount());
        Assert.assertTrue(20 == autoShape.getTextFrame().getTextFrameFormat().getColumnSpacing());
    } finally {
        if (test1 != null) test1.dispose();
    }

    format.setColumnCount(3);
    format.setColumnSpacing(15);
    pres.save(outPptxFileName, SaveFormat.Pptx);

    Presentation test2 = new Presentation(outPptxFileName);
    try {
        IAutoShape autoShape = ((AutoShape)test2.getSlides().get_Item(0).getShapes().get_Item(0));
        Assert.assertTrue(3 == autoShape.getTextFrame().getTextFrameFormat().getColumnCount());
        Assert.assertTrue(15 == autoShape.getTextFrame().getTextFrameFormat().getColumnSpacing());
    } finally {
        if (test2 != null) test2.dispose();
    }
} finally {
    if (pres != null) pres.dispose();
}

Perbarui Teks

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

Kode Java berikut mendemonstrasikan operasi memperbarui semua teks dalam sebuah presentasi:

Presentation pres = new Presentation("text.pptx");
try {
    for (ISlide slide : pres.getSlides())
    {
        for (IShape shape : slide.getShapes())
        {
            if (shape instanceof IAutoShape) //Memeriksa apakah shape mendukung text frame (IAutoShape).
            {
                IAutoShape autoShape = (IAutoShape)shape; 
                for (IParagraph paragraph : autoShape.getTextFrame().getParagraphs()) //Iterasi melalui paragraf dalam text frame
                {
                    for (IPortion portion : paragraph.getPortions()) //Iterasi melalui setiap portion dalam paragraf
                    {
                        portion.setText(portion.getText().replace("years", "months")); //Mengubah teks
                        portion.getPortionFormat().setFontBold(NullableBool.True); //Mengubah format
                    }
                }
            }
        }
    }

    //Menyimpan presentasi yang dimodifikasi
    pres.save("text-changed.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Tambahkan Kotak Teks dengan Hyperlink

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

Untuk menambahkan kotak teks yang berisi tautan, ikuti langkah‑langkah berikut:

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

Kode Java ini—implementasi dari langkah‑langkah di atas—menunjukkan cara menambahkan kotak teks dengan hyperlink ke slide:

// Membuat instance kelas Presentation yang merepresentasikan PPTX
Presentation pres = new Presentation();
try {
    // Mendapatkan slide pertama dalam presentasi
    ISlide slide = pres.getSlides().get_Item(0);

    // Menambahkan objek AutoShape dengan tipe diatur sebagai Rectangle
    IShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 150, 150, 150, 50);

    // Meng-cast shape menjadi AutoShape
    IAutoShape pptxAutoShape = (IAutoShape)shape;

    // Mengakses properti ITextFrame yang terkait dengan AutoShape
    pptxAutoShape.addTextFrame("");

    ITextFrame textFrame = pptxAutoShape.getTextFrame();

    // Menambahkan teks ke frame
    textFrame.getParagraphs().get_Item(0).getPortions().get_Item(0).setText("Aspose.Slides");

    // Menetapkan Hyperlink untuk teks portion
    IHyperlinkManager hyperlinkManager = textFrame.getParagraphs().get_Item(0).getPortions().get_Item(0).
            getPortionFormat().getHyperlinkManager();
    hyperlinkManager.setExternalHyperlinkClick("http://www.aspose.com");

    // Menyimpan Presentasi PPTX
    pres.save("hLink_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

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

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

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

Batasi iterasi Anda hanya pada auto‑shape yang memiliki text frame dan kecualikan objek terembed (chart, table, SmartArt) dengan menelusuri koleksi mereka secara terpisah atau melewatkan tipe objek tersebut.

Kelola Placeholder Presentasi di Android Meningkatkan Presentasi Anda dengan AutoFit di Android