Android でプレゼンテーションの図形を管理する

このページの概要

Aspose.Slides for Android via Java を使用して、プレゼンテーションの図形を識別、調整、クローン作成、削除、非表示、順序変更、エクスポート、配置、フリップする方法を学びます。

概要

Aspose.Slides for Android via Java は、スライド上の図形を順序付けされたIShapeCollectionとして表します。このコレクションは図形を検索・変更する場所であると同時に、スタック順序の情報源でもあり、インデックス 0 が最背面の図形、最後のインデックスが最前面の図形です。

本記事はこのモデルに従います。まず、図形を確実に特定し、プリセットの調整ポイントを変更する方法を説明し、続いて図形のクローン作成、削除、非表示、並び替えを示します。最後のセクションでは、レイアウトレベルの書式設定、SVG へのエクスポート、配置、フリップ設定を扱います。各例は独立しているため、ワークフローで必要な操作だけを使用できます。

図形の識別と検索

コレクションインデックスは既知のファイルを処理する際に便利ですが、安定した識別子ではありません。図形の追加、削除、並び替えによりインデックスは変わります。プレゼンテーションの作成・保守方法に応じて識別子を選択してください。

Name は、開発者が管理するテンプレートに便利で、PowerPoint の選択ウィンドウで確認しやすいです。名前は編集可能ですが一意である保証はないため、コードが名前に依存する場合は命名規則を策定してください。
AlternativeText は、アクセシビリティの説明や作者が付与したタグで図形が既に特定できる場合に便利です。ユーザーに表示され、ローカライズやアクセシビリティ向上のために書き換えられることがあるため、一意である保証はありません。意味のあるアクセシビリティテキストをデータベースキーとして静かに再利用しないでください。
OfficeInteropShapeId は読み取り専用の識別子で、スライド内で一意であり、PowerPoint のインタープリットで使用される図形 ID に対応します。PowerPoint との連携や、図形のライフタイム全体で曖昧さのない参照が必要なときに使用してください。クローンや再作成された図形は別の図形となり、独自の ID が割り当てられます。

関連するgetUniqueId メソッドはプレゼンテーションスコープの識別子を返しますが、これはアドイン向けで再割り当てされる可能性があるため、永続的な外部キーとして扱うべきではありません。長期的な同一性が重要な場合は、アプリケーションデータにマッピングを保持し、期待する図形がまだ存在するか検証してください。

以下の例は名前で完全一致検索し、スライドスコープのインタープリット ID を報告します。テンプレートに期待する図形が存在しない場合、コードはその結果を報告し、誤ったオブジェクトで続行しません。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IShape targetShape = null;
    for (IShape shape : slide.getShapes()) {
        if ("RevenueChart".equals(shape.getName())) {
            targetShape = shape;
            break;
        }
    }

    if (targetShape == null) {
        System.out.println("The shape 'RevenueChart' was not found on slide 1.");
    } else {
        System.out.println("Found " + targetShape.getName() + "; interop ID: " + targetShape.getOfficeInteropShapeId());
    }
} finally {
    presentation.dispose();
}

操作が特定の図形タイプに限定される場合は、型固有メンバーを使用する前にインターフェイスを確認してください。この例は、名前で取得したオブジェクトが IAutoShape である場合にのみテキストと代替テキストを更新します。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IShape candidate = null;
    for (IShape shape : slide.getShapes()) {
        if ("StatusLabel".equals(shape.getName())) {
            candidate = shape;
            break;
        }
    }

    if (candidate instanceof IAutoShape) {
        IAutoShape autoShape = (IAutoShape) candidate;
        autoShape.getTextFrame().setText("Approved");
        autoShape.setAlternativeText("Approval status: approved");
        presentation.save("identified-shape.pptx", SaveFormat.Pptx);
    } else {
        System.out.println("'StatusLabel' is missing or is not an AutoShape.");
    }
} finally {
    presentation.dispose();
}

プリセット図形の調整ポイントの識別と変更

プリセットジオメトリ図形は、角のサイズ、矢印の比率、弧の角度などを制御する調整ポイントを公開することがあります。これらは読み取り専用の IGeometryShape.getAdjustments コレクションを介してアクセスします。コレクション自体は図形から提供されますが、各 IAdjustValue が変更可能な値を保持しています。

固定のコレクションインデックスだけに依存しないでください。調整項目を列挙し、読み取り専用の getType メソッドで ShapeAdjustmentType 値を確認してください。この値が調整が制御する内容を示します。読み取り専用の getName メソッドは追加の識別情報を提供し、同一のセマンティックタイプが複数ある場合に特に有用です。

調整の意味に合ったメソッドを使用してください。

調整タイプ	用途	変更すべきメソッド
`CornerSize`	角丸のサイズ	setRawValue
`ArrowTailThickness`	矢尻の太さ	`setRawValue`
`ArrowheadLength`	矢尻の長さ	`setRawValue`
`ArrowheadWidth`	矢尻の幅	`setRawValue`
`StartAngle`	パイまたは弧の開始角度	setAngleValue
`EndAngle`	パイまたは弧の終了角度	`setAngleValue`

getType と getName は読み取り専用情報を返します。getRawValue と setRawValue はプリセットのネイティブジオメトリ単位の整数で動作し、getAngleValue と setAngleValue は度単位の角度で動作します。調整項目の数、順序、意味、有効範囲はプリセットの ShapeType に依存します。あるプリセットで有効な値が別のプリセットでは無効、または別の効果を持つことがあります。

getType が ShapeAdjustmentType.Custom を返す場合、API は標準的なセマンティック意味を認識していません。getName、プリセットタイプ、既存の値を確認し、期待する意味と範囲が分からない限り調整は変更しないでください。認識されたタイプでも、同一タイプが複数回出現するかどうかを確認してから値を選択してください。コネクタのベンド調整に関する例は Connector 記事をご参照ください。

以下の完全な例は、3 つのプリセット図形のデフォルト版と変更版を作成します。すべての調整項目を列挙し、名前とタイプを報告し、サイズ関連の値は setRawValue、角度は setAngleValue で変更し、結果を保存します。左列はデフォルトジオメトリを保持し、右列は調整された角丸長方形、四方向矢印、パイを示します。

import com.aspose.slides.*;

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

    // デフォルトと調整された図形列のヘッダーを追加します。
    IAutoShape defaultColumnLabel = slide.getShapes().addAutoShape(ShapeType.Rectangle, 40, 20, 250, 30);
    defaultColumnLabel.getTextFrame().setText("Default preset geometry");
    IAutoShape adjustedColumnLabel = slide.getShapes().addAutoShape(ShapeType.Rectangle, 390, 20, 250, 30);
    adjustedColumnLabel.getTextFrame().setText("Modified adjustment values");

    slide.getShapes().addAutoShape(ShapeType.RoundCornerRectangle, 80, 70, 160, 70);
    IGeometryShape modifiedRoundedRectangle = slide.getShapes().addAutoShape(ShapeType.RoundCornerRectangle, 430, 70, 160, 70);
    modifiedRoundedRectangle.setName("ModifiedRoundedRectangle");

    slide.getShapes().addAutoShape(ShapeType.QuadArrow, 80, 180, 160, 110);
    IGeometryShape modifiedArrow = slide.getShapes().addAutoShape(ShapeType.QuadArrow, 430, 180, 160, 110);
    modifiedArrow.setName("ModifiedQuadArrow");

    slide.getShapes().addAutoShape(ShapeType.Pie, 95, 330, 130, 130);
    IGeometryShape modifiedPie = slide.getShapes().addAutoShape(ShapeType.Pie, 445, 330, 130, 130);
    modifiedPie.setName("ModifiedPie");

    IGeometryShape[] shapesToAdjust = {
        modifiedRoundedRectangle,
        modifiedArrow,
        modifiedPie
    };

    for (IGeometryShape shape : shapesToAdjust) {
        for (int adjustmentIndex = 0; adjustmentIndex < shape.getAdjustments().size(); adjustmentIndex++) {
            IAdjustValue adjustment = shape.getAdjustments().get_Item(adjustmentIndex);
            System.out.println(shape.getName() + " / " + adjustment.getName() + ": " + adjustment.getType());

            switch (adjustment.getType()) {
                case ShapeAdjustmentType.CornerSize:
                    adjustment.setRawValue(5000);
                    break;
                case ShapeAdjustmentType.ArrowTailThickness:
                    adjustment.setRawValue(25000);
                    break;
                case ShapeAdjustmentType.ArrowheadLength:
                    adjustment.setRawValue(30000);
                    break;
                case ShapeAdjustmentType.ArrowheadWidth:
                    adjustment.setRawValue(40000);
                    break;
                case ShapeAdjustmentType.StartAngle:
                    adjustment.setAngleValue(30);
                    break;
                case ShapeAdjustmentType.EndAngle:
                    adjustment.setAngleValue(300);
                    break;
                case ShapeAdjustmentType.Custom:
                    System.out.println("Custom adjustment '" + adjustment.getName() + "' was not changed.");
                    break;
            }
        }
    }

    presentation.save("preset-shape-adjustments.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

値を変更する前にセマンティックタイプを確認することで、コードの意図が明示的になり、異なるプリセット図形間で同一インデックスが同じ意味を持つと仮定することを防げます。

図形コレクションの変更

add、clone、remove、reorder メソッドはコレクションに即座に作用します。操作によって図形の数や順序が変わる場合、操作前に取得したインデックスに依存し続けないでください。

図形のクローン作成

addClone は独立したコピーを作成し、対象コレクションの末尾に追加します。insertClone もコピーを作成しますが、指定した Z オーダーインデックスに配置します。座標だけを受け取るオーバーロードはサイズを変更せずにクローンを移動し、幅・高さを受け取るオーバーロードはサイズも変更できます。

この例は宛先スライドを作成し、ラベル付き長方形を前面にクローンし、2 番目のクローンを背面に挿入します。どちらのクローンを変更しても元の図形には影響しません。

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide sourceSlide = presentation.getSlides().get_Item(0);
    IAutoShape sourceShape = sourceSlide.getShapes().addAutoShape(ShapeType.Rectangle, 40, 40, 180, 60);
    sourceShape.setName("SourceLabel");
    sourceShape.getTextFrame().setText("Source");

    ILayoutSlide blankLayout = presentation.getMasters().get_Item(0).getLayoutSlides().getByType(SlideLayoutType.Blank);
    ISlide destinationSlide = presentation.getSlides().addEmptySlide(blankLayout);

    IShape frontCloneShape = destinationSlide.getShapes().addClone(sourceShape, 80, 80);
    frontCloneShape.setName("FrontClone");
    if (frontCloneShape instanceof IAutoShape) {
        IAutoShape frontClone = (IAutoShape) frontCloneShape;
        frontClone.getTextFrame().setText("Front clone");
    } else {
        System.out.println("The front clone is not an AutoShape; its text was not changed.");
    }

    IShape backCloneShape = destinationSlide.getShapes().insertClone(0, sourceShape, 80, 180);
    backCloneShape.setName("BackClone");
    if (backCloneShape instanceof IAutoShape) {
        IAutoShape backClone = (IAutoShape) backCloneShape;
        backClone.getTextFrame().setText("Back clone");
    } else {
        System.out.println("The back clone is not an AutoShape; its text was not changed.");
    }

    presentation.save("cloned-shapes.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

クローンは図形のコンテンツと書式、名前、代替テキストをすべてコピーします。これらの値が一意である必要がある場合は、クローンに新しい論理識別子を割り当ててください。複雑な図形で使用されるリソースはプレゼンテーションが管理しますが、クローンは新しいコレクション項目であり新しい図形 ID を持ちます。

図形の削除

remove は特定の図形オブジェクトをコレクションから削除します。インデックス付きで複数マッチを削除する場合は、残りのインデックスが有効なままになるように末尾から走査してください。

この例は指定された名前を持つすべての図形を削除します。固定のコレクション項目ではなく、現在のインデックスで図形を取得し、不要なキャストも行いません。

import com.aspose.slides.*;

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

    IAutoShape keepShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 40, 40, 140, 60);
    keepShape.setName("Keep");

    IAutoShape firstTemporaryShape = slide.getShapes().addAutoShape(ShapeType.Ellipse, 220, 40, 80, 80);
    firstTemporaryShape.setName("Temporary");

    IAutoShape secondTemporaryShape = slide.getShapes().addAutoShape(ShapeType.Triangle, 340, 40, 100, 80);
    secondTemporaryShape.setName("Temporary");

    for (int i = slide.getShapes().size() - 1; i >= 0; i--) {
        IShape shape = slide.getShapes().get_Item(i);
        if ("Temporary".equals(shape.getName())) {
            slide.getShapes().remove(shape);
        }
    }

    presentation.save("removed-shapes.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

削除後は図形数と後続のインデックスが変わります。影響を受けない図形への参照は保存されたインデックスより信頼性が高くなります。また、コネクタやアニメーションなど、削除対象オブジェクトを参照しているプレゼンテーション機能があるか考慮してください。可視図形を削除すると、スライドの外観以上の影響が出ることがあります。

図形の非表示

Hidden を true に設定すると、図形はコレクションに残りますが、通常のスライドショーには表示されません。インデックス、書式、コンテンツはコードから引き続き利用可能なため、後で復元できるオプション要素に適しています。

import com.aspose.slides.*;

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

    IAutoShape visibleShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 40, 40, 160, 60);
    visibleShape.setName("VisibleLabel");

    IAutoShape optionalShape = slide.getShapes().addAutoShape(ShapeType.Moon, 240, 40, 100, 100);
    optionalShape.setName("OptionalDecoration");

    for (IShape shape : slide.getShapes()) {
        if ("OptionalDecoration".equals(shape.getName())) {
            shape.setHidden(true);
        }
    }

    presentation.save("hidden-shape.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

非表示は削除やセキュリティ機能ではありません。ユーザーやコードが再度表示状態に変更でき、プレゼンテーションファイルの一部として残ります。

Z オーダーの変更

重なり合う図形はコレクション順に描画されます。reorder は既存の図形をクローンせずに指定インデックスへ移動します。インデックス 0 が背面、size() - 1 が前面です。

import com.aspose.slides.*;
import java.awt.Color;

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

    IAutoShape blueRectangle = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 220, 120);
    blueRectangle.setName("BlueRectangle");
    blueRectangle.getFillFormat().setFillType(FillType.Solid);
    blueRectangle.getFillFormat().getSolidFillColor().setColor(Color.BLUE);

    IAutoShape orangeEllipse = slide.getShapes().addAutoShape(ShapeType.Ellipse, 180, 140, 220, 120);
    orangeEllipse.setName("OrangeEllipse");
    orangeEllipse.getFillFormat().setFillType(FillType.Solid);
    orangeEllipse.getFillFormat().getSolidFillColor().setColor(Color.rgb(255, 165, 0));

    slide.getShapes().reorder(slide.getShapes().size() - 1, blueRectangle);
    presentation.save("reordered-shapes.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

長方形は最初に作成され、最初は楕円の背面にあります。最終インデックスへ移動すると前面に表示されます。すべての関連図形を追加またはクローンした後で Z オーダーを確定してください。これらの操作は新しいコレクション項目を追加または挿入し、スタック順序を変える可能性があります。

レイアウトスライド上の図形の検査

通常スライド、レイアウトスライド、マスタースライドはそれぞれ別個の図形コレクションを持ちます。レイアウトコレクションにある図形は、通常スライド上の同位置の図形とは別オブジェクトです。レイアウトが提供する書式を理解または変更する必要がある場合は、レイアウト図形を検査してください。

以下の例は、各レイアウト図形の FillFormat と LineFormat を取得し、すべてが AutoShape であるとは限らないことを前提に処理します。

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    for (ILayoutSlide layoutSlide : presentation.getLayoutSlides()) {
        for (IShape shape : layoutSlide.getShapes()) {
            int fillType = shape.getFillFormat().getFillType();
            double lineWidth = shape.getLineFormat().getWidth();
            System.out.println(layoutSlide.getName() + " / " + shape.getName() + ": fill=" + fillType + ", line width=" + lineWidth);
        }
    }
} finally {
    presentation.dispose();
}

レイアウトを編集すると、そのレイアウトを使用している複数のスライドに影響が及びます。レイアウト図形を変更する前に、通常スライドがオブジェクトを継承しているかローカルで上書きしているかを判断し、レイアウトを使用しているすべてのスライドでテストしてください。

図形を SVG にエクスポート

writeAsSvg は単一図形の描画結果をストリームに書き込みます。出力には図形自体だけが含まれ、スライド全体の背景や隣接図形は含まれません。

import com.aspose.slides.*;
import java.io.FileOutputStream;
import java.io.IOException;

Presentation presentation = new Presentation("input.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    if (slide.getShapes().size() == 0) {
        System.out.println("Slide 1 does not contain a shape to export.");
    } else {
        IShape shape = slide.getShapes().get_Item(0);
        try (FileOutputStream svgStream = new FileOutputStream("shape.svg")) {
            shape.writeAsSvg(svgStream);
        } catch (IOException exception) {
            System.out.println("The SVG file could not be written: " + exception.getMessage());
        }
    }
} finally {
    presentation.dispose();
}

レンダリング中はプレゼンテーションを開いたままにしてください。出力は図形の書式やフォント、画像といったリソースに依存します。全体の構成が必要な場合は、個別図形ではなくスライド全体をエクスポートしてください。ストリームの所有権は呼び出し側にあり、使用後は必ず閉じてください。

図形の配置

SlideUtil.alignShapes のオーバーロードは、すべての図形または選択したコレクションインデックスを整列させます。ShapesAlignmentType でエッジ、中心線、または分布モードを指定します。alignToSlide を true に設定するとスライドの端に合わせ、false にすると選択図形同士の相対位置で整列します。

この例は 3 つの図形をスライド上部エッジに整列させます。返された図形参照は整列直前に現在のインデックスへ変換されます。

import com.aspose.slides.*;

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

    IAutoShape firstShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 60, 80, 120, 50);
    IAutoShape secondShape = slide.getShapes().addAutoShape(ShapeType.Ellipse, 240, 160, 120, 50);
    IAutoShape thirdShape = slide.getShapes().addAutoShape(ShapeType.Triangle, 420, 240, 120, 50);
    firstShape.setName("FirstAlignedShape");
    secondShape.setName("SecondAlignedShape");
    thirdShape.setName("ThirdAlignedShape");

    int[] shapeIndexes = {slide.getShapes().indexOf(firstShape), slide.getShapes().indexOf(secondShape), slide.getShapes().indexOf(thirdShape)};

    SlideUtil.alignShapes(ShapesAlignmentType.AlignTop, true, slide, shapeIndexes);
    presentation.save("aligned-shapes.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

配置は位置を変更しますが Z オーダーは変わりません。相対配置は通常 2 つ以上の図形が必要で、水平または垂直の分布は間隔を定義できるだけの図形が必要です。メソッド呼び出し前にコレクションを変更した場合はインデックスを再計算してください。

図形のフリップ

ShapeFrame クラスは位置、サイズ、水平・垂直フリップ設定、回転を保持します。getFlipH と getFlipV の値は NullableBool を使用し、True でフリップ有効、False で無効、NotDefined で未指定/デフォルト状態を保持します。

以下の入力プレゼンテーションにはフリップされていない図形が 1 つ含まれています。

フリップ前の図形

この例は他のフレーム値はすべて保持し、フリップ設定の2つだけを置き換えます。新しい Frame を割り当てるとフレーム全体が上書きされるため重要です。

import com.aspose.slides.*;

Presentation presentation = new Presentation("sample.pptx");
try {
    IShape shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0);
    IShapeFrame frame = shape.getFrame();

    System.out.println("Horizontal flip before change: " + frame.getFlipH());
    System.out.println("Vertical flip before change: " + frame.getFlipV());

    shape.setFrame(new ShapeFrame(frame.getX(), frame.getY(), frame.getWidth(), frame.getHeight(), NullableBool.True, NullableBool.True, frame.getRotation()));

    presentation.save("flipped-shape.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

保存された図形は水平・垂直にミラーリングされますが、位置、サイズ、回転はそのまま保持されます。

フリップ後の図形

FAQ

コレクションインデックスを図形の識別子として使用すべきですか？

コレクションが変更されない短時間の処理に限って使用してください。テンプレートが作者管理の場合は検証済みの Name または AlternativeText を、スライドスコープのインタープリット作業には OfficeInteropShapeId を優先してください。

図形を非表示にすると Z オーダーから除外されますか？

いいえ。非表示の図形は同じインデックスでコレクションに残り、検索、並び替え、編集、再表示が可能です。

クローンした図形が別の図形の前に表示されたのはなぜですか？

addClone はクローンをコレクションの末尾に追加します。コレクションの末尾は Z オーダーの前面です。初期インデックスを指定したい場合は insertClone を使用するか、すべての図形追加後に reorder で調整してください。

プリセット図形の調整を固定インデックスで識別できますか？

正確なプリセットとコレクション配置を検証した場合に限り可能です。IGeometryShape.getAdjustments を走査し IAdjustValue.getType を確認する方法を推奨します。同一セマンティックタイプが複数ある場合は IAdjustValue.getName を補助情報として使用してください。

Android でのプレゼンテーションにおけるシェイプエフェクトの適用 Android のプレゼンテーションからシェイプの有効なプロパティを取得する