Androidでのプレゼンテーションにおけるテキストボックスの管理

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

Info

Aspose.Slides には、スライドにシェイプを追加できる IShape インターフェイスも用意されています。ただし、IShape インターフェイスを介して追加されたすべてのシェイプがテキストを保持できるわけではありません。一方、IAutoShape インターフェイスを介して追加されたシェイプはテキストを含めることができます。

Note

したがって、テキストを追加したいシェイプを扱う場合は、IAutoShape インターフェイスにキャストされていることを確認する必要があります。IAutoShape であることが確認できて初めて、IAutoShape のプロパティである TextFrame を使用できます。このページの Update Text セクションを参照してください。

Create a Text Box on a Slide

テキストボックスをスライドに作成する手順は次のとおりです。

Presentation クラスのインスタンスを作成します。
新しく作成したプレゼンテーションの最初のスライドへの参照を取得します。
スライド上の指定位置に Rectangle に設定した ShapeType を持つ IAutoShape オブジェクトを追加し、新しく追加された IAutoShape オブジェクトへの参照を取得します。
テキストを保持する TextFrame プロパティを IAutoShape オブジェクトに追加します。以下の例では、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);

    // 四角形に 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();
}

Check for a Text Box Shape

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

テキストボックスとシェイプ

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

単に IShapeCollection インターフェイスの addAutoShape メソッドでオートシェイプを追加した場合、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 を返します

Add Columns to a Text Box

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

以下の 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);

    // 四角形に 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();
}

Add Columns to a Text Frame

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

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

Update Text

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

Add a Text Box with a Hyperlink

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

テキストボックスにリンクを含めるには、次の手順を実行します。

Presentation クラスのインスタンスを作成します。
新しく作成したプレゼンテーションの最初のスライドへの参照を取得します。
スライド上の指定位置に Rectangle に設定した ShapeType を持つ 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

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

A placeholder は master からスタイル/位置を継承し、layouts で上書き可能です。一方、通常のテキストボックスは特定のスライド上の独立したオブジェクトであり、レイアウトを切り替えても変わりません。

チャート、テーブル、SmartArt 内のテキストを除外して、プレゼンテーション全体で一括テキスト置換を行うにはどうすればよいですか？

テキストフレームを持つオートシェイプに対してのみ反復処理を行い、埋め込みオブジェクト（charts、tables、SmartArt）はそれぞれのコレクションを別途走査するか、該当オブジェクトタイプをスキップしてください。

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