形状操作

スライド内の形状を見つける

このトピックでは、開発者が内部Idを使用せずにスライド上で特定の形状を見つけるのを容易にするための簡単なテクニックについて説明します。PowerPointプレゼンテーションファイルには、内部の一意のIdを除いてスライド上の形状を識別する手段がないことを知っておくことが重要です。開発者が内部の一意のIdを使用して形状を見つけるのは難しいようです。スライドに追加されたすべての形状には、いくつかの代替テキストがあります。特定の形状を見つけるために、開発者に代替テキストを使用することをお勧めします。将来変更を計画しているオブジェクトの代替テキストを定義するために、MS PowerPointを使用できます。

希望する形状の代替テキストを設定した後、Aspose.Slides for Androidを介してJavaを使用してそのプレゼンテーションを開き、スライドに追加されたすべての形状を反復処理できます。各反復の間に、形状の代替テキストを確認し、一致する代替テキストを持つ形状が必要な形状となります。このテクニックをより良く示すために、特定の形状をスライド内で見つけて、その形状を単純に返すメソッドfindShapeを作成しました。

// プレゼンテーションクラスをインスタンス化してプレゼンテーションファイルを表す
Presentation pres = new Presentation("FindingShapeInSlide.pptx");
try {

    ISlide slide = pres.getSlides().get_Item(0);
    // 見つけたい形状の代替テキスト
    IShape shape = findShape(slide, "Shape1");
    if (shape != null)
    {
        System.out.println("形状名: " + shape.getName());
    }
} finally {
    if (pres != null) pres.dispose();
}

// 代替テキストを使用してスライド内の形状を見つけるメソッドの実装
public static IShape findShape(ISlide slide, String alttext)
{
    // スライド内のすべての形状を反復処理
    for (int i = 0; i < slide.getShapes().size(); i++)
    {
        // スライドの代替テキストが必要なものと一致する場合
        // 形状を返す
        if (slide.getShapes().get_Item(i).getAlternativeText().compareTo(alttext) == 0)
            return slide.getShapes().get_Item(i);
    }
    return null;
}

形状をクローンする

Aspose.Slides for Androidを介してJavaを使用してスライドに形状をクローンするには:

  1. Presentationクラスのインスタンスを作成します。
  2. インデックスを使用してスライドの参照を取得します。
  3. ソーススライドの形状コレクションにアクセスします。
  4. プレゼンテーションに新しいスライドを追加します。
  5. ソーススライドの形状コレクションから新しいスライドに形状をクローンします。
  6. 修正されたプレゼンテーションをPPTXファイルとして保存します。

以下の例は、スライドにグループ形状を追加します。

// プレゼンテーションクラスをインスタンス化
Presentation pres = new Presentation("Source Frame.pptx");
try {
    IShapeCollection sourceShapes = pres.getSlides().get_Item(0).getShapes();
    ILayoutSlide blankLayout = pres.getMasters().get_Item(0).getLayoutSlides().getByType(SlideLayoutType.Blank);
    ISlide destSlide = pres.getSlides().addEmptySlide(blankLayout);
    IShapeCollection destShapes = destSlide.getShapes();
    destShapes.addClone(sourceShapes.get_Item(1), 50, 150 + sourceShapes.get_Item(0).getHeight());
    destShapes.addClone(sourceShapes.get_Item(2));
    destShapes.insertClone(0, sourceShapes.get_Item(0), 50, 150);

    // PPTXファイルをディスクに書き込む
    pres.save("CloneShape_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

形状を削除する

Aspose.Slides for Androidを介してJavaは、開発者が任意の形状を削除できるようにします。任意のスライドから形状を削除するには、以下の手順に従ってください。

  1. Presentationクラスのインスタンスを作成します。
  2. 最初のスライドにアクセスします。
  3. 特定のAlternativeTextを持つ形状を見つけます。
  4. 形状を削除します。
  5. ファイルをディスクに保存します。
// プレゼンテーションオブジェクトを作成
Presentation pres = new Presentation();
try {
    // 最初のスライドを取得
    ISlide sld = pres.getSlides().get_Item(0);

    // 四角形のオートシェイプを追加
    sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
    sld.getShapes().addAutoShape(ShapeType.Moon, 160, 40, 150, 50);

    String altText = "ユーザー定義";
    int iCount = sld.getShapes().size();
    for (int i = 0; i < iCount; i++)
    {
        AutoShape ashp = (AutoShape)sld.getShapes().get_Item(0);
        if (altText.equals(ashp.getAlternativeText()))
        {
            sld.getShapes().remove(ashp);
        }
    }

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

形状を非表示にする

Aspose.Slides for Androidを介してJavaは、開発者が任意の形状を非表示にすることを可能にします。任意のスライドから形状を非表示にするには、以下の手順に従ってください。

  1. Presentationクラスのインスタンスを作成します。
  2. 最初のスライドにアクセスします。
  3. 特定のAlternativeTextを持つ形状を見つけます。
  4. 形状を非表示にします。
  5. ファイルをディスクに保存します。
// PPTXを表すプレゼンテーションクラスをインスタンス化する
Presentation pres = new Presentation();
try {
    // 最初のスライドを取得
    ISlide sld = pres.getSlides().get_Item(0);

    // 四角形のオートシェイプを追加
    sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
    sld.getShapes().addAutoShape(ShapeType.Moon, 160, 40, 150, 50);

    String altText = "ユーザー定義";
    int iCount = sld.getShapes().size();
    for (int i = 0; i < iCount; i++)
    {
        AutoShape ashp = (AutoShape)sld.getShapes().get_Item(i);
        if (altText.equals(ashp.getAlternativeText()))
        {
            ashp.setHidden(true);
        }
    }

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

形状の順序を変更する

Aspose.Slides for Androidを介してJavaは、開発者が形状の順序を変更できるようにします。形状の順序を変更することで、どの形状が前面にあるか、どの形状が背面にあるかを指定できます。任意のスライドから形状の順序を変更するには、以下の手順に従ってください。

  1. Presentationクラスのインスタンスを作成します。
  2. 最初のスライドにアクセスします。
  3. 形状を追加します。
  4. 形状のテキストフレームにテキストを追加します。
  5. 同じ座標の別の形状を追加します。
  6. 形状の順序を変更します。
  7. ファイルをディスクに保存します。
Presentation pres = new Presentation("ChangeShapeOrder.pptx");
try {
    ISlide slide = pres.getSlides().get_Item(0);
    IAutoShape shp3 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 365, 400, 150);
    shp3.getFillFormat().setFillType(FillType.NoFill);
    shp3.addTextFrame(" ");

    IParagraph para = shp3.getTextFrame().getParagraphs().get_Item(0);
    IPortion portion = para.getPortions().get_Item(0);
    portion.setText("ウォーターマークテキスト ウォーターマークテキスト ウォーターマークテキスト");

    shp3 = slide.getShapes().addAutoShape(ShapeType.Triangle, 200, 365, 400, 150);

    slide.getShapes().reorder(2, shp3);

    pres.save("Reshape_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

インターロップ形状IDを取得する

Aspose.Slides for Androidを介してJavaは、開発者がスライドスコープ内での一意の形状識別子を取得できるようにします。getUniqueIdメソッドは、プレゼンテーションスコープ内での一意の識別子を取得することを許可します。getOfficeInteropShapeIdメソッドは、IShapeインターフェースおよびShapeクラスに追加されました。メソッドgetOfficeInteropShapeIdが返す値は、Microsoft.Office.Interop.PowerPoint.ShapeオブジェクトのIdの値に対応します。以下にサンプルコードを示します。

Presentation pres = new Presentation("Presentation.pptx");
try {
    // スライドスコープ内での一意の形状識別子を取得
    long officeInteropShapeId = pres.getSlides().get_Item(0).getShapes().get_Item(0).getOfficeInteropShapeId();

} finally {
    if (pres != null) pres.dispose();
}

形状の代替テキストを設定する

Aspose.Slides for Androidを介してJavaは、開発者が任意の形状の代替テキストを設定できるようにします。 プレゼンテーション内の形状は、AlternativeTextまたはShape Nameメソッドによって区別できます。 setAlternativeTextおよびgetAlternativeTextメソッドは、Aspose.SlidesやMicrosoft PowerPointを使用して読み取りまたは設定できます。 この方法を使用することで、形状にタグを付け、形状を削除する、形状を非表示にする、またはスライド上の形状の順序を変更するなどのさまざまな操作を実行できます。 形状の代替テキストを設定するには、以下の手順に従ってください。

  1. Presentationクラスのインスタンスを作成します。
  2. 最初のスライドにアクセスします。
  3. スライドに任意の形状を追加します。
  4. 新しく追加した形状で何らかの作業を行います。
  5. 形状を見つけるために形状を走査します。
  6. 代替テキストを設定します。
  7. ファイルをディスクに保存します。
// PPTXを表すプレゼンテーションクラスをインスタンス化する
Presentation pres = new Presentation();
try {
    // 最初のスライドを取得
    ISlide sld = pres.getSlides().get_Item(0);

    // 四角形のオートシェイプを追加
    IShape shp1 = sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
    IShape shp2 = sld.getShapes().addAutoShape(ShapeType.Moon, 160, 40, 150, 50);
    shp2.getFillFormat().setFillType(FillType.Solid);
    shp2.getFillFormat().getSolidFillColor().setColor(Color.GRAY);

    for (int i = 0; i < sld.getShapes().size(); i++)
    {
        AutoShape shape = (AutoShape) sld.getShapes().get_Item(i);
        if (shape != null)
        {
            shape.setAlternativeText("ユーザー定義");
        }
    }

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

形状のレイアウトフォーマットにアクセスする

Aspose.Slides for Androidを介してJavaは、形状のレイアウトフォーマットにアクセスするためのシンプルなAPIを提供します。このドキュメントでは、レイアウトフォーマットにアクセスする方法を示します。

以下にサンプルコードを示します。

Presentation pres = new Presentation("pres.pptx");
try {
    for (ILayoutSlide layoutSlide : pres.getLayoutSlides())
    {
        for (IShape shape : layoutSlide.getShapes())
        {
            IFillFormat fillFormats = shape.getFillFormat();
            ILineFormat lineFormats = shape.getLineFormat();
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

形状をSVGとしてレンダリングする

現在、Aspose.Slides for Androidを介してJavaは形状をSVGとしてレンダリングする機能を提供しています。メソッドgetOfficeInteropShapeId（およびそのオーバーロード）がShapeクラスおよびIShapeインターフェースに追加されました。このメソッドは、形状の内容をSVGファイルとして保存することを可能にします。以下のコードスニペットは、スライドの形状をSVGファイルにエクスポートする方法を示します。

Presentation pres = new Presentation("TestExportShapeToSvg.pptx");
try {
    FileOutputStream stream = new FileOutputStream("SingleShape.svg");
    try {
        pres.getSlides().get_Item(0).getShapes().get_Item(0).writeAsSvg(stream);
    } finally {
        if (stream != null) stream.close();
    }
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

形状の整列

Aspose.Slidesでは、形状をスライドのマージンに対して相対的に、または相互に整列することができます。この目的のために、オーバーロードされたメソッドSlidesUtil.alignShape()が追加されました。ShapesAlignmentType列挙型は、可能な整列オプションを定義します。

例1

以下のソースコードは、インデックス1、2、および4の形状をスライドの上の境界に沿って整列させます。

Presentation pres = new Presentation("example.pptx");
try {
    ISlide slide = pres.getSlides().get_Item(0);
    IShape shape1 = slide.getShapes().get_Item(1);
    IShape shape2 = slide.getShapes().get_Item(2);
    IShape shape3 = slide.getShapes().get_Item(4);
    SlideUtil.alignShapes(ShapesAlignmentType.AlignTop, true, pres.getSlides().get_Item(0), new int[]
    {
        slide.getShapes().indexOf(shape1),
        slide.getShapes().indexOf(shape2),
        slide.getShapes().indexOf(shape3)
    });
} finally {
    if (pres != null) pres.dispose();
}

例2

以下の例は、コレクション内の最も下の形状に対して、すべての形状コレクションを整列させる方法を示します。

Presentation pres = new Presentation("example.pptx");
try {
    SlideUtil.alignShapes(ShapesAlignmentType.AlignBottom, false, pres.getSlides().get_Item(0));
} finally {
    if (pres != null) pres.dispose();
}
形状効果 シェイプ効果的プロパティ