Javaでプレゼンテーションのテキストボックスを管理する

スライド上のテキストは通常、テキストボックスまたはシェイプに存在します。そのため、スライドにテキストを追加するには、テキストボックスを追加し、そのテキストボックス内にテキストを入れる必要があります。Aspose.Slides for Java は、テキストを含むシェイプを追加できるIAutoShapeインターフェイスを提供します。

Info

Aspose.Slides は、スライドにシェイプを追加できるIShapeインターフェイスも提供します。ただし、IShapeインターフェイスを通じて追加されたすべてのシェイプがテキストを保持できるわけではありません。IAutoShapeインターフェイスを通じて追加されたシェイプはテキストを含む場合があります。

Note

したがって、テキストを追加したいシェイプを扱う際には、IAutoShapeインターフェイスにキャストされているか確認した方が良いでしょう。そうすれば、IAutoShapeのプロパティであるTextFrameを使用できます。このページのUpdate Textセクションを参照してください。

スライド上にテキストボックスを作成する

Presentationクラスのインスタンスを作成します。
新しく作成したプレゼンテーションの最初のスライドへの参照を取得します。
スライド上の指定位置にRectangleに設定されたShapeTypeを持つIAutoShapeオブジェクトを追加し、新しく追加されたIAutoShapeオブジェクトへの参照を取得します。
テキストを含むIAutoShapeオブジェクトにTextFrameプロパティを追加します。以下の例では、Aspose TextBoxというテキストを追加しました。
最後に、Presentationオブジェクトを使用してPPTXファイルを書き出します。

このJavaコード（上記手順の実装）は、スライドにテキストを追加する方法を示しています。

// プレゼンテーションをインスタンス化します
Presentation pres = new Presentation();
try {
    // プレゼンテーションの最初のスライドを取得します
    ISlide sld = pres.getSlides().get_Item(0);

    // タイプを Rectangle に設定した AutoShape を追加します
    IAutoShape ashp = sld.getShapes().addAutoShape(ShapeType.Rectangle, 150, 75, 150, 50);

    // Rectangle に TextFrame を追加します
    ashp.addTextFrame(" ");

    // テキストフレームにアクセスします
    ITextFrame txtFrame = ashp.getTextFrame();

    // テキストフレームの Paragraph オブジェクトを作成します
    IParagraph para = txtFrame.getParagraphs().get_Item(0);

    // Paragraph の Portion オブジェクトを作成します
    IPortion portion = para.getPortions().get_Item(0);

    // テキストを設定します
    portion.setText("Aspose TextBox");

    // プレゼンテーションをディスクに保存します
    pres.save("TextBox_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

テキストボックス形状のチェック

Aspose.Slides は、IAutoShapeインターフェイスのisTextBoxメソッドを提供し、シェイプを調べてテキストボックスかどうかを判別できます。

Text box and shape

このJavaコードは、シェイプがテキストボックスとして作成されたかどうかを確認する方法を示しています。

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

addAutoShapeメソッド（IShapeCollectionインターフェイス）を使用して単にオートシェイプを追加した場合、オートシェイプのisTextBoxメソッドはfalseを返します。ただし、addTextFrameメソッドまたはsetTextメソッドでオートシェイプにテキストを追加すると、isTextBoxプロパティは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() は false を返します
shape1.addTextFrame("shape 1");
// shape1.isTextBox() は true を返します

IAutoShape shape2 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 110, 100, 40);
// shape2.isTextBox() は false を返します
shape2.getTextFrame().setText("shape 2");
// shape2.isTextBox() は true を返します

IAutoShape shape3 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 210, 100, 40);
// shape3.isTextBox() は false を返します
shape3.addTextFrame("");
// shape3.isTextBox() は false を返します

IAutoShape shape4 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 310, 100, 40);
// shape4.isTextBox() は false を返します
shape4.getTextFrame().setText("");
// shape4.isTextBox() は false を返します

テキストボックスに列を追加する

Aspose.Slides は、テキストボックスに列を追加できるColumnCountおよびColumnSpacingプロパティ（ITextFrameFormatインターフェイスおよびTextFrameFormatクラスから）を提供します。テキストボックスの列数を指定し、列間のポイント単位の間隔を設定できます。

このJavaコードは、上記の操作を示しています。

Presentation pres = new Presentation();
try {
    // プレゼンテーションの最初のスライドを取得します
    ISlide slide = pres.getSlides().get_Item(0);

    // タイプを Rectangle に設定した AutoShape を追加します
    IAutoShape aShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);

    // Rectangle に TextFrame を追加します
    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!");

    // TextFrame のテキストフォーマットを取得します
    ITextFrameFormat format = aShape.getTextFrame().getTextFrameFormat();

    // TextFrame の列数を指定します
    format.setColumnCount(3);

    // 列間の間隔を指定します
    format.setColumnSpacing(10);

    // プレゼンテーションを保存します
    pres.save("ColumnCount.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

テキストフレームに列を追加する

Aspose.Slides for Java は、テキストフレームに列を追加できるColumnCountプロパティ（ITextFrameFormatインターフェイス）を提供します。このプロパティを使用して、テキストフレーム内の列数を指定できます。

このJavaコードは、テキストフレーム内に列を追加する方法を示しています。

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

テキストの更新

Aspose.Slides を使用すると、テキストボックス内のテキストやプレゼンテーション全体に含まれるテキストを変更または更新できます。

このJavaコードは、プレゼンテーション内のすべてのテキストを更新または変更する操作を示しています。

Presentation pres = new Presentation("text.pptx");
try {
    for (ISlide slide : pres.getSlides())
    {
        for (IShape shape : slide.getShapes())
        {
            if (shape instanceof IAutoShape) // シェイプがテキストフレーム（IAutoShape）をサポートしているかチェックします。
            {
                IAutoShape autoShape = (IAutoShape)shape; 
                for (IParagraph paragraph : autoShape.getTextFrame().getParagraphs()) // テキストフレーム内の段落を反復処理します。
                {
                    for (IPortion portion : paragraph.getPortions()) // 段落内の各ポーションを反復処理します。
                    {
                        portion.setText(portion.getText().replace("years", "months")); // テキストを変更します。
                        portion.getPortionFormat().setFontBold(NullableBool.True); // 書式設定を変更します。
                    }
                }
            }
        }
    }

    // 変更されたプレゼンテーションを保存します。
    pres.save("text-changed.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

ハイパーリンク付きテキストボックスの追加

テキストボックス内にリンクを挿入できます。テキストボックスがクリックされると、ユーザーはリンク先を開きます。

Presentationクラスのインスタンスを作成します。
新しく作成したプレゼンテーションの最初のスライドへの参照を取得します。
スライド上の指定位置にShapeTypeがRectangleに設定されたAutoShapeオブジェクトを追加し、新しく追加されたAutoShapeオブジェクトへの参照を取得します。
デフォルトテキストとしてAspose TextBoxを含むTextFrameをAutoShapeオブジェクトに追加します。
IHyperlinkManagerクラスのインスタンスを作成します。
TextFrameの対象部分に関連付けられたHyperlinkClickプロパティにIHyperlinkManagerオブジェクトを割り当てます。
最後に、Presentationオブジェクトを使用してPPTXファイルを書き出します。

このJavaコード（上記手順の実装）は、ハイパーリンク付きテキストボックスをスライドに追加する方法を示しています。

// PPTX を表す Presentation クラスのインスタンスを作成します
Presentation pres = new Presentation();
try {
    // プレゼンテーションの最初のスライドを取得します
    ISlide slide = pres.getSlides().get_Item(0);

    // タイプを Rectangle に設定した AutoShape オブジェクトを追加します
    IShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 150, 150, 150, 50);

    // シェイプを AutoShape にキャストします
    IAutoShape pptxAutoShape = (IAutoShape)shape;

    // AutoShape に関連付けられた ITextFrame プロパティにアクセスします
    pptxAutoShape.addTextFrame("");

    ITextFrame textFrame = pptxAutoShape.getTextFrame();

    // フレームにテキストを追加します
    textFrame.getParagraphs().get_Item(0).getPortions().get_Item(0).setText("Aspose.Slides");

    // ポーションテキストにハイパーリンクを設定します
    IHyperlinkManager hyperlinkManager = textFrame.getParagraphs().get_Item(0).getPortions().get_Item(0).
            getPortionFormat().getHyperlinkManager();
    hyperlinkManager.setExternalHyperlinkClick("http://www.aspose.com");

    // PPTX プレゼンテーションを保存します
    pres.save("hLink_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

マスタースライドでテキストボックスとテキストプレースホルダーの違いは何ですか？

プレースホルダー(placeholder)は、マスタースライドからスタイルと位置を継承し、レイアウトで上書きできます。一方、通常のテキストボックスは特定のスライド上の独立したオブジェクトであり、レイアウトを切り替えても変更されません。

チャート、テーブル、SmartArt 内のテキストを変更せずに、プレゼンテーション全体でテキストを一括置換するにはどうすればよいですか？

テキストフレームを持つオートシェイプのみを対象に反復処理し、埋め込みオブジェクト（チャート、テーブル、SmartArt）を除外するために、これらのコレクションを別々に走査するか、該当オブジェクトタイプをスキップしてください。

Javaでプレゼンテーションのプレースホルダーを管理 Java で AutoFit を使用してプレゼンテーションを強化する