Python で PowerPoint スライドをクローン
はじめに
クローンとは、何かを正確にコピーまたは複製するプロセスです。Aspose.Slides は任意のスライドをコピー(クローン)し、クローンしたスライドを現在のプレゼンテーションまたは別の開いているプレゼンテーションに挿入することも可能です。スライドのクローン作成により、元のスライドに影響を与えることなく新しいスライドを変更できます。スライドをクローンする方法はいくつかあります。
- プレゼンテーションの末尾にクローンする。
- プレゼンテーション内の別の位置にクローンする。
- 別のプレゼンテーションの末尾にクローンする。
- 別のプレゼンテーションの別の位置にクローンする。
- 別のプレゼンテーションの特定の位置にクローンする。
Aspose.Slides for Python via .NET では、Presentation オブジェクトが提供するslide collectionに add_clone および insert_clone メソッドがあり、これらのスライド クローン操作を実行できます。
インストール
pip install aspose.slides
同一プレゼンテーション内で末尾にクローン
同一プレゼンテーション内でスライドをクローンし、既存のスライドの末尾に追加したい場合は add_clone メソッドを使用します。手順は以下の通りです。
- Presentation クラスのインスタンスを作成します。
- Presentation オブジェクトからスライドコレクションを取得します。
- クローン対象のスライドを指定して、SlideCollection の
add_cloneメソッドを呼び出します。 - 変更したプレゼンテーションを保存します。
以下の例では、最初のスライド(インデックス 0)をクローンし、プレゼンテーションの末尾に追加します。
import aspose.slides as slides
# プレゼンテーション ファイルを表すために Presentation クラスのインスタンスを作成します。
with slides.Presentation("CloneWithinSamePresentationToEnd.pptx") as presentation:
# 同じプレゼンテーション内のスライド コレクションの末尾に目的のスライドをクローンします。
presentation.slides.add_clone(presentation.slides[0])
# 変更されたプレゼンテーションをディスクに保存します。
presentation.save("Aspose_CloneWithinSamePresentationToEnd_out.pptx", slides.export.SaveFormat.PPTX)
同一プレゼンテーション内で特定の位置にクローン
同一プレゼンテーション内でスライドをクローンし、別の位置に配置したい場合は insert_clone メソッドを使用します。
- Presentation クラスのインスタンスを作成します。
- Presentation オブジェクトからスライドコレクションを取得します。
- クローン対象のスライドと新しい位置のインデックスを指定して、SlideCollection の
insert_cloneメソッドを呼び出します。 - 変更したプレゼンテーションを保存します。
以下の例では、インデックス 1(位置 2)のスライドをインデックス 2(位置 3)にクローンします。
import aspose.slides as slides
# プレゼンテーション ファイルを表すために Presentation クラスのインスタンスを作成します。
with slides.Presentation("CloneWithInSamePresentation.pptx") as presentation:
# 同じプレゼンテーション内で目的のスライドを指定した位置(インデックス)にクローンします。
presentation.slides.insert_clone(2, presentation.slides[1])
# 変更されたプレゼンテーションをディスクに保存します。
presentation.save("Aspose_CloneWithInSamePresentation_out.pptx", slides.export.SaveFormat.PPTX)
別のプレゼンテーションの末尾にクローン
あるプレゼンテーションからスライドをクローンし、別のプレゼンテーションの末尾に追加したい場合の手順です。
- ソースプレゼンテーション(クローン元スライドを含む)用に Presentation のインスタンスを作成します。
- 宛先プレゼンテーション(スライドを追加する先)用に Presentation のインスタンスを作成します。
- 宛先プレゼンテーションからスライドコレクションを取得します。
- 宛先のSlideCollection で
add_cloneを呼び出し、ソースプレゼンテーションのスライドを渡します。 - 変更した宛先プレゼンテーションを保存します。
以下の例では、ソースプレゼンテーションのインデックス 0 のスライドを宛先プレゼンテーションの末尾にクローンします。
import aspose.slides as slides
# ソース プレゼンテーション ファイルを表すために Presentation クラスのインスタンスを作成します。
with slides.Presentation("CloneAtEndOfAnother.pptx") as source_presentation:
# スライドをクローンする先の PPTX(宛先プレゼンテーション)用に Presentation クラスのインスタンスを作成します。
with slides.Presentation() as target_presentation:
# ソース プレゼンテーションから目的のスライドを、宛先プレゼンテーションのスライドコレクションの末尾にクローンします。
target_presentation.slides.add_clone(source_presentation.slides[0])
# 宛先プレゼンテーションをディスクに保存します。
target_presentation.save("Aspose2_out.pptx", slides.export.SaveFormat.PPTX)
別のプレゼンテーションの特定の位置にクローン
あるプレゼンテーションからスライドをクローンし、別のプレゼンテーションの特定の位置に挿入したい場合の手順です。
- ソースプレゼンテーション(クローン元スライドを含む)用に Presentation のインスタンスを作成します。
- 宛先プレゼンテーション(スライドを追加する先)用に Presentation のインスタンスを作成します。
- 宛先プレゼンテーションからスライドコレクションを取得します。
- 宛先のSlideCollection で
insert_cloneメソッドを呼び出し、ソーススライドと目的のインデックスを渡します。 - 変更した宛先プレゼンテーションを保存します。
以下の例では、ソースプレゼンテーションのインデックス 0 のスライドを宛先プレゼンテーションのインデックス 2(位置 3)にクローンします。
import aspose.slides as slides
# ソース プレゼンテーション ファイルを表すために Presentation クラスのインスタンスを作成します。
with slides.Presentation("CloneAtEndOfAnother.pptx") as source_presentation:
# スライドをクローンする先の PPTX(宛先プレゼンテーション)用に Presentation クラスのインスタンスを作成します。
with slides.Presentation("Aspose2_out.pptx") as target_presentation:
# ソースの最初のスライドを宛先プレゼンテーションのインデックス 2 にクローンとして挿入します。
target_presentation.slides.insert_clone(2, source_presentation.slides[0])
# デスティネーション プレゼンテーションをディスクに保存します。
target_presentation.save("Aspose3_out.pptx", slides.export.SaveFormat.PPTX)
マスタースライドを含むスライドを別のプレゼンテーションにクローン
スライド とそのマスター を別のプレゼンテーションにクローンして使用したい場合、まずソースプレゼンテーションから対象のマスタースライドを宛先プレゼンテーションにクローンします。その後、コピー先のマスターを使用してスライドをクローンします。add_clone(Slide, MasterSlide) メソッドは、ソースではなく宛先プレゼンテーションの マスタースライド を受け取ります。
スライドとマスターをクローンする手順は次のとおりです。
- ソースプレゼンテーション用に Presentation のインスタンスを作成します。
- 宛先プレゼンテーション用に Presentation のインスタンスを作成します。
- クローンするスライドとそのマスタースライドにアクセスします。
- 宛先プレゼンテーションのマスターコレクションから MasterSlideCollection を取得します。
add_cloneを宛先のMasterSlideCollection で呼び出し、ソースのマスターをクローンして宛先に追加します。- 宛先プレゼンテーションのスライドコレクションから SlideCollection を取得します。
add_cloneを宛先のSlideCollection で呼び出し、ソーススライドとクローンした宛先マスターを渡します。- 変更した宛先プレゼンテーションを保存します。
以下の例では、ソースプレゼンテーションのインデックス 0 のスライドを、ソースからクローンしたマスターを使用して宛先プレゼンテーションの末尾にクローンします。
import aspose.slides as slides
# ソース プレゼンテーション ファイルを表す Presentation クラスのインスタンスを作成します。
with slides.Presentation("CloneToAnotherPresentationWithMaster.pptx") as source_presentation:
# スライドをクローンする先のプレゼンテーション(宛先)用に Presentation クラスのインスタンスを作成します。
with slides.Presentation() as target_presentation:
# ソース プレゼンテーションから最初のスライドを取得します。
source_slide = source_presentation.slides[0]
# 最初のスライドで使用されているマスタースライドを取得します。
source_master = source_slide.layout_slide.master_slide
# デスティネーション プレゼンテーションのマスタコレクションにマスタースライドをクローンします。
cloned_master = target_presentation.masters.add_clone(source_master)
# クローンしたマスターを使用して、ソースプレゼンテーションのスライドを宛先プレゼンテーションの末尾にクローンします。
target_presentation.slides.add_clone(source_slide, cloned_master, True)
# デスティネーション プレゼンテーションをディスクに保存します。
target_presentation.save("CloneToAnotherPresentationWithMaster_out.pptx", slides.export.SaveFormat.PPTX)
指定セクションの末尾にクローン
Aspose.Slides for Python via .NET では、プレゼンテーションのあるセクションからスライドをクローンし、同一プレゼンテーション内の別のセクションに挿入できます。その際は SlideCollection クラスの add_clone(Slide, Section) メソッドを使用します。
以下の Python の例は、スライドをクローンして指定セクションに挿入する方法を示しています。
import aspose.slides as slides
# 新しい空白のプレゼンテーションを作成します。
with slides.Presentation() as presentation:
# 最初のスライドのレイアウトに基づく空のスライドを追加します。
slide = presentation.slides.add_empty_slide(presentation.slides[0].layout_slide)
# 新しいスライドに楕円形シェイプを追加します。このスライドは後でクローンされます。
slide.shapes.add_auto_shape(slides.ShapeType.ELLIPSE, 150, 150, 100, 100)
# 最初のスライドのレイアウトに基づく別の空のスライドを追加します。
slide2 = presentation.slides.add_empty_slide(presentation.slides[0].layout_slide)
# "Section2" という名前のセクションを作成し、slide2 から開始します。
section = presentation.sections.add_section("Section2", slide2)
# 以前に作成したスライドを "Section2" セクションにクローンします。
presentation.slides.add_clone(slide, section)
# プレゼンテーションを PPTX ファイルとして保存します。
presentation.save("presentation.pptx", slides.export.SaveFormat.PPTX)
スライドサイズの一致を確認
スライドを別のプレゼンテーションにクローンする場合、宛先プレゼンテーションのスライドサイズがソースと同じであることを確認してください。サイズが異なると、Aspose.Slides はクローンしたシェイプのサイズを自動的に再スケールせず、元の座標と寸法が保持されるため、コンテンツがずれたりスライド境界を超えたりする可能性があります。
クローンする前に、宛先プレゼンテーションのスライドサイズをソースに合わせて設定できます。
source_size = source_presentation.slide_size.size
target_presentation.slide_size.set_size(
source_size.width, source_size.height, slides.SlideSizeScaleType.DO_NOT_SCALE)
この操作は、マスターとスライドをクローンする前に実行してください。
FAQ
スピーカーノートやレビュアーコメントもクローンされますか?
はい。ノートページとレビューコメントはクローンに含まれます。不要な場合は、挿入後に削除するしてください。
チャートとそのデータ ソースはどう扱われますか?
チャートオブジェクト、書式設定、および埋め込みデータはコピーされます。チャートが外部ソース(例: OLE 埋め込みワークブック)にリンクされている場合、そのリンクはOLE objectとして保持されます。ファイル間で移動した後は、データの可用性と更新動作を確認してください。
クローンの挿入位置やセクションを制御できますか?
はい。特定のスライドインデックスにクローンを挿入し、選択したsectionに配置できます。対象セクションが存在しない場合は、まず作成してからスライドを移動してください。