スライドのクローン

プレゼンテーション内のスライドのクローン

クローンとは、何かの正確なコピーまたはレプリカを作成するプロセスです。Aspose.Slides for Javaでは、任意のスライドのコピーまたはクローンを作成し、そのクローンを現在のプレゼンテーションまたは他の開いているプレゼンテーションに挿入することが可能です。スライドのクローン作成プロセスでは、新しいスライドが作成され、開発者が元のスライドを変更することなく修正できるようになります。スライドをクローンする方法はいくつかあります：

プレゼンテーションの最後にクローン。
プレゼンテーション内の別の位置にクローン。
別のプレゼンテーションの最後にクローン。
別のプレゼンテーションの別の位置にクローン。
別のプレゼンテーションの特定の位置にクローン。

Aspose.Slides for Javaでは、Presentationオブジェクトによって公開されるISlideオブジェクトのコレクション（ISlideCollection）が、上記のタイプのスライドクローン作成を実行するためにaddCloneメソッドおよびinsertCloneメソッドを提供します。

プレゼンテーション内の最後にクローン

スライドをクローンし、既存のスライドの最後に同じプレゼンテーションファイル内で使用したい場合は、以下の手順に従ってaddCloneメソッドを使用してください：

Presentationクラスのインスタンスを作成します。
Presentationオブジェクトによって公開されるスライドコレクションを参照して、ISlideCollectionクラスをインスタンス化します。
ISlideCollectionオブジェクトによって公開されるaddCloneメソッドを呼び出し、クローンするスライドをaddCloneメソッドへのパラメータとして渡します。
修正したプレゼンテーションファイルを書き込みます。

以下の例では、プレゼンテーションの最初の位置（ゼロインデックス）にあるスライドをプレゼンテーションの最後にクローンしました。

// プレゼンテーションファイルを表すPresentationクラスをインスタンス化
Presentation pres = new Presentation("CloneWithinSamePresentationToEnd.pptx");
try {
    // 同じプレゼンテーション内のスライドのコレクションの最後に目的のスライドをクローン
    ISlideCollection slds = pres.getSlides();

    slds.addClone(pres.getSlides().get_Item(0));

    // 修正したプレゼンテーションをディスクに書き込み
    pres.save("Aspose_CloneWithinSamePresentationToEnd_out.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

プレゼンテーション内の別の位置にクローン

スライドをクローンし、同じプレゼンテーションファイル内の別の位置で使用したい場合は、insertCloneメソッドを使用します：

Presentationクラスのインスタンスを作成します。
Presentationオブジェクトによって公開されるSlidesコレクションを参照してクラスをインスタンス化します。
ISlideCollectionオブジェクトによって公開されるinsertCloneメソッドを呼び出し、クローンするスライドと新しい位置のインデックスをinsertCloneメソッドへのパラメータとして渡します。
修正したプレゼンテーションをPPTXファイルとして書き込みます。

以下の例では、プレゼンテーションのゼロインデックス（位置1）にあるスライドをインデックス1（位置2）にクローンしました。

// プレゼンテーションファイルを表すPresentationクラスをインスタンス化
Presentation pres = new Presentation("CloneWithInSamePresentation.pptx");
try {
    // 同じプレゼンテーション内のスライドのコレクションの最後に目的のスライドをクローン
    ISlideCollection slds = pres.getSlides();

    // 指定されたインデックスに同じプレゼンテーション内で目的のスライドをクローン
    slds.insertClone(2, pres.getSlides().get_Item(1));

    // 修正したプレゼンテーションをディスクに書き込み
    pres.save("Aspose_CloneWithInSamePresentation_out.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

別のプレゼンテーションの最後にクローン

スライドを1つのプレゼンテーションから別のプレゼンテーションファイルにクローンし、既存のスライドの最後に使用したい場合：

スライドをクローンするプレゼンテーションを含むPresentationクラスのインスタンスを作成します。
スライドが追加される宛先プレゼンテーションを含むPresentationクラスのインスタンスを作成します。
宛先プレゼンテーションのPresentationオブジェクトによって公開されるSlidesコレクションを参照してISlideCollectionクラスをインスタンス化します。
ISlideCollectionオブジェクトによって公開されるaddCloneメソッドを呼び出し、ソースプレゼンテーションから取得したスライドをaddCloneメソッドへのパラメータとして渡します。
修正した宛先プレゼンテーションファイルを書き込みます。

以下の例では、ソースプレゼンテーションの最初のインデックスからスライドを宛先プレゼンテーションの最後にクローンしました。

// ソースプレゼンテーションファイルを読み込むためのPresentationクラスをインスタンス化
Presentation srcPres = new Presentation("CloneAtEndOfAnother.pptx");
try {
    // クローン先のPPTX用のPresentationクラスをインスタンス化（ここにスライドをクローン）
    Presentation destPres = new Presentation();
    try {
        // ソースプレゼンテーションから目的のスライドを宛先プレゼンテーション内のスライドのコレクションの最後にクローン
        ISlideCollection slds = destPres.getSlides();

        slds.addClone(srcPres.getSlides().get_Item(0));

        // 宛先プレゼンテーションをディスクに書き込み
        destPres.save("Aspose2_out.pptx", SaveFormat.Pptx);
    } finally {
        destPres.dispose();
    }
} finally {
    srcPres.dispose();
}

別のプレゼンテーションの別の位置にクローン

スライドを1つのプレゼンテーションから別のプレゼンテーションファイルにクローンし、特定の位置で使用したい場合：

スライドをクローンするソースプレゼンテーションを含むPresentationクラスのインスタンスを作成します。
スライドを追加するプレゼンテーションを含むPresentationクラスのインスタンスを作成します。
宛先プレゼンテーションのPresentationオブジェクトによって公開されるSlidesコレクションを参照して、ISlideCollectionクラスをインスタンス化します。
ISlideCollectionオブジェクトによって公開されるinsertCloneメソッドを呼び出し、ソースプレゼンテーションからのスライドと必要な位置をinsertCloneメソッドへのパラメータとして渡します。
修正した宛先プレゼンテーションファイルを書き込みます。

以下の例では、ソースプレゼンテーションのゼロインデックスからスライドを宛先プレゼンテーションのインデックス1（位置2）にクローンしました。

// ソースプレゼンテーションファイルを読み込むためのPresentationクラスをインスタンス化
Presentation srcPres = new Presentation("CloneAtEndOfAnother.pptx");
try {
    // クローン先のPPTX用のPresentationクラスをインスタンス化（ここにスライドをクローン）
    Presentation destPres = new Presentation();
    try {
        // ソースプレゼンテーションから宛先プレゼンテーション内のスライドのコレクションの終了に目的のスライドをクローン
        ISlideCollection slds = destPres.getSlides();

        slds.insertClone(2, srcPres.getSlides().get_Item(0));

        // 宛先プレゼンテーションをディスクに書き込み
        destPres.save("Aspose2_out.pptx", SaveFormat.Pptx);
    } finally {
        destPres.dispose();
    }
} finally {
    srcPres.dispose();
}

別のプレゼンテーションの特定の位置にクローン

スライドをマスタースライドと共に1つのプレゼンテーションから別のプレゼンテーションにクローンし使用する必要がある場合、最初にソースプレゼンテーションから目的のマスタースライドを宛先プレゼンテーションにクローンする必要があります。その後、そのマスタースライドを使用してマスタースライド付きのスライドをクローンする必要があります。addClone(ISlide, IMasterSlide, boolean)は、ソースプレゼンテーションではなく宛先プレゼンテーションからのマスタースライドを期待します。マスターを持つスライドをクローンするには、以下の手順に従ってください：

スライドをクローンするソースプレゼンテーションを含むPresentationクラスのインスタンスを作成します。
スライドをクローンする宛先プレゼンテーションを含むPresentationクラスのインスタンスを作成します。
クローンするスライドとマスタースライドにアクセスします。
宛先プレゼンテーションのPresentationオブジェクトによって公開されるマスターコレクションを参照して、IMasterSlideCollectionクラスをインスタンス化します。
IMasterSlideCollectionオブジェクトによって公開されるaddCloneメソッドを呼び出し、クローンするためのソースPPTXのマスターをaddCloneメソッドへのパラメータとして渡します。
宛先プレゼンテーションのPresentationオブジェクトによって公開されるSlidesコレクションを参照して、ISlideCollectionクラスをインスタンス化します。
ISlideCollectionオブジェクトによって公開されるaddCloneメソッドを呼び出し、クローンするためのソースプレゼンテーションのスライドとマスタースライドをaddCloneメソッドへのパラメータとして渡します。
修正した宛先プレゼンテーションファイルを書き込みます。

以下の例では、ソースプレゼンテーションのゼロインデックスにあるマスタースライド付きのスライドを宛先プレゼンテーションの最後にソーススライドのマスターを使用してクローンしました。

// ソースプレゼンテーションファイルを読み込むためのPresentationクラスをインスタンス化
Presentation srcPres = new Presentation("CloneToAnotherPresentationWithMaster.pptx");
try {
    // クローン先のプレゼンテーション（ここにスライドをクローン）用のPresentationクラスをインスタンス化
    Presentation destPres = new Presentation();
    try {
        // ソースプレゼンテーションのスライドコレクションからISlideをインスタンス化し、マスタースライドと共に取得
        ISlide SourceSlide = srcPres.getSlides().get_Item(0);
        IMasterSlide SourceMaster = SourceSlide.getLayoutSlide().getMasterSlide();

        // ソースプレゼンテーションから宛先プレゼンテーションのマスターのコレクションへの目的のマスタースライドをクローン
        IMasterSlideCollection masters = destPres.getMasters();
        IMasterSlide DestMaster = SourceSlide.getLayoutSlide().getMasterSlide();

        // ソースプレゼンテーションのマスタースライドを宛先プレゼンテーションのマスターのコレクションにクローン
        IMasterSlide iSlide = masters.addClone(SourceMaster);

        // ソースプレゼンテーションの目的のスライドを宛先プレゼンテーションのスライドのコレクションの最後にクローン
        ISlideCollection slds = destPres.getSlides();
        slds.addClone(SourceSlide, iSlide, true);

        // 宛先プレゼンテーションをディスクに保存
        destPres.save("CloneToAnotherPresentationWithMaster_out.pptx", SaveFormat.Pptx);
    } finally {
        destPres.dispose();
    }
} finally {
    srcPres.dispose();
}

指定されたセクションの最後にクローン

スライドをクローンし、同じプレゼンテーションファイル内で異なるセクションで使用したい場合は、addCloneメソッドを使用します。ISlideCollectionインターフェースによって公開されるメソッドを使用して、Aspose.Slides for Javaでは最初のセクションからスライドをクローンし、そのクローンを同じプレゼンテーションの2番目のセクションに挿入することができます。

以下のコードスニペットでは、スライドをクローンしてクローンしたスライドを指定されたセクションに挿入する方法を示します。

IPresentation presentation = new Presentation();
try {
    presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 200, 50, 300, 100);
    presentation.getSections().addSection("セクション 1", presentation.getSlides().get_Item(0));

    ISection section2 = presentation.getSections().appendEmptySection("セクション 2");
    presentation.getSlides().addClone(presentation.getSlides().get_Item(0), section2);
    
	// 宛先プレゼンテーションをディスクに保存
    presentation.save(dataDir + "CloneSlideIntoSpecifiedSection.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

プレゼンテーションからスライドを削除するスライドの比較