チュートリアル

簡単にライブラリーを使用するためのチュートリアルコレクション

チュートリアル»Python»Spire.XLS for Python»変換»Python で Excel を TXT に変換:区切り文字と文字コード
2026-11-20

Python で PowerPoint に OLE オブジェクトを挿入・抽出・削除する方法

提案書に予算表、議事録に参照資料——PowerPoint のスライドに別のファイルをそのまま埋め込めると、資料を 1 つのファイルで配れるようになります。この埋め込みの仕組みが OLE(Object Linking and Embedding)オブジェクトです。スライド上にはアイコンとして表示され、ダブルクリックすると元のアプリケーションで開きます。

本記事では、Spire.Presentation for Python で OLE オブジェクトを扱う手順を紹介します。Excel・Word・PDF・ZIP の 4 種類をスライドに埋め込むところから、埋め込んだファイルを元の形式で取り出すところ、不要になったオブジェクトを削除するところまで、実際のスライドを見ながら進めます。

クイックナビゲーション


1. OLE オブジェクトで添付資料を 1 つのスライドにまとめる

OLE オブジェクトは、別のアプリケーションのファイルをスライドの中に包み込んだものです。埋め込まれたファイルそのものが pptx の中に入るため、受け取った側は元のファイルを別途用意する必要がありません。

Spire.Presentation for Python では、次の 3 つの操作を組み合わせて使います。

操作 使用する API できること
挿入 ISlide.Shapes.AppendOleObject() ファイルをスライドに埋め込み、アイコンを表示する
抽出 IOleObject.Data 埋め込まれたファイルを元の形式で取り出す
削除 ISlide.Shapes.Remove() スライドからオブジェクトを取り除く

挿入したオブジェクトは、IOleObject.ProgId に「何のファイルか」を示す文字列を持ちます。抽出するときは、この値を見て保存するファイルの拡張子を決めます。


2. 準備:ライブラリとサンプル資料

pip install spire.presentation

スクリプトでは、spire.presentation と spire.presentation.common を読み込みます。ファイルを読み書きする Stream や座標の RectangleF は common 側にあります。

import os
from spire.presentation.common import *
from spire.presentation import *

サンプルには、共有資料に添付する 4 つのファイルと、スライドに表示するアイコンを用意しました。

ファイル 内容 ProgID
予算案.xlsx 上期・下期の予算 4 行 Excel.Sheet.12
議事録.docx 定例打ち合わせの議事録 Word.Document.12
提案書.pdf 1 ページの提案概要 Acrobat.Document
素材一式.zip ロゴと写真のフォルダ Package

アイコンは icons/ フォルダに PNG で用意します。スライドに表示されるのはこの画像なので、ファイルの種類が分かるものを 1 つずつ用意しておくと、受け取った側が迷いません。


3. スライドにファイルを埋め込む

空のプレゼンテーションを作り、1 枚目のスライドに 4 つのファイルを 2 行 2 列に並べて埋め込みます。

import os
from spire.presentation.common import *
from spire.presentation import *

os.makedirs("output", exist_ok=True)

# 添付する資料(名前, ファイル, アイコン, ProgID)
items = [
    ("excel", "files/予算案.xlsx", "icons/excel-icon.png", "Excel.Sheet.12"),
    ("word", "files/議事録.docx", "icons/word-icon.png", "Word.Document.12"),
    ("pdf", "files/提案書.pdf", "icons/pdf-icon.png", "Acrobat.Document"),
    ("zip", "files/素材一式.zip", "icons/zip-icon.png", "Package"),
]

ppt = Presentation()
slide = ppt.Slides[0]

# スライドの見出し
title = slide.Shapes.AppendShape(ShapeType.Rectangle, RectangleF.FromLTRB(40, 30, 680, 96))
title.Fill.FillType = FillFormatType.Solid
title.Fill.SolidColor.Color = Color.FromRgb(31, 78, 121)
title.Line.FillType = FillFormatType.none
title.TextFrame.Text = "共有資料 ― 添付ファイル一覧"
title.TextFrame.TextRange.FontHeight = 22
title.TextFrame.TextRange.FontColor = Color.get_White()

# 2 行 2 列に並べながら OLE オブジェクトを追加する
for i, (name, path, icon_path, prog_id) in enumerate(items):
    icon = ppt.Images.AppendStream(Stream(icon_path))
    left = 210 + (i % 2) * 190
    top = 178 + (i // 2) * 170
    rect = RectangleF.FromLTRB(left, top, left + icon.Width, top + icon.Height)
    ole = slide.Shapes.AppendOleObject(name, Stream(path), rect)
    ole.SubstituteImagePictureFillFormat.Picture.EmbedImage = icon
    ole.ProgId = prog_id

ppt.SaveToFile("output/OLEオブジェクト.pptx", FileFormat.Pptx2010)
ppt.Dispose()

print("保存しました: output/OLEオブジェクト.pptx")
print("ファイルサイズ:", os.path.getsize("output/OLEオブジェクト.pptx"), "bytes")

AppendOleObject() の引数は、オブジェクト名・埋め込むファイルのストリーム・配置する矩形です。矩形の幅と高さをアイコン画像の Width / Height に合わせているので、スライド上でもアイコンの形が崩れません。

SubstituteImagePictureFillFormat.Picture.EmbedImage にアイコン画像を渡すと、その画像がスライド上の見た目になります。ProgId は埋め込むファイルの種類に合わせて指定します。

スライドに埋め込んだ OLE オブジェクトと右クリックメニュー

保存した pptx を開くと、4 つのアイコンが並んだスライドになっています。アイコンを右クリックすると「excel オブジェクト」という項目が現れ、Edit / Open から元のアプリケーションで開けます。スライド上の見た目は画像ですが、中身は Excel ブックそのものです。

埋め込みデータは pptx 内の ppt/embeddings/ に格納されるため、元のファイルを別途用意しなくても、あとから取り出せます。


4. 埋め込んだファイルを取り出す

埋め込まれたファイルは、スライドを走査して IOleObject かどうかを判定し、Data から取り出します。

import os
from spire.presentation.common import *
from spire.presentation import *

os.makedirs("output/抽出", exist_ok=True)

# ProgID から、保存するファイルの拡張子を決める
suffixes = {
    "Excel.Sheet.12": "xlsx",
    "Word.Document.12": "docx",
    "Acrobat.Document": "pdf",
    "Package": "zip",
}

presentation = Presentation()
presentation.LoadFromFile("output/OLEオブジェクト.pptx")

for slide in presentation.Slides:
    for shape in slide.Shapes:
        if isinstance(shape, IOleObject):
            suffix = suffixes.get(shape.ProgId, "bin")
            path = f"output/抽出/{shape.ObjectName}.{suffix}"
            data = shape.Data
            data.Save(path)
            data.Close()
            print("抽出しました:", path, os.path.getsize(path), "bytes")

presentation.Dispose()

isinstance(shape, IOleObject) で OLE オブジェクトだけを選び、Data で中身のストリームを取得します。保存したファイルは、埋め込み前と同じサイズ・同じ形式になります。

shape.ObjectName は挿入時に付けた名前(excel / word / pdf / zip)なので、そのままファイル名に使えます。ProgId が想定外の値だった場合は bin として保存するようにしておくと、拡張子の取り違えを防げます。

抽出した 4 つのファイル

抽出したファイルはそのまま開けます。Excel の予算表、Word の議事録、PDF の提案書、ZIP の素材フォルダが、それぞれ元の形式で output/抽出 に並びます。


5. 不要になった OLE オブジェクトを削除する

配布する相手に合わせて添付を外したい場合は、OLE オブジェクトだけを削除します。

from spire.presentation.common import *
from spire.presentation import *

presentation = Presentation()
presentation.LoadFromFile("output/OLEオブジェクト.pptx")

for slide in presentation.Slides:
    # 先に一覧を作ってから削除する
    ole_shapes = [shape for shape in slide.Shapes if isinstance(shape, IOleObject)]
    for shape in ole_shapes:
        slide.Shapes.Remove(shape)
    print("削除したオブジェクト数:", len(ole_shapes))

presentation.SaveToFile("output/OLEオブジェクト_削除後.pptx", FileFormat.Pptx2010)
presentation.Dispose()

削除は ISlide.Shapes.Remove() にオブジェクトを渡すだけです。ただし、slide.Shapes を反復しながらその場で削除すると、残りの要素の位置がずれて取りこぼしが起きます。先にリストへ集めてから削除する、という順序にしておくと確実です。

OLE オブジェクトを削除した後のスライド

見出しや図形はそのまま残り、OLE オブジェクトだけが消えます。スライドの中身を入れ替えるのではなく、添付だけを外したい場面に向いています。実行すると「削除したオブジェクト数: 4」と表示されるので、対象の数も確認できます。


6. まとめ

本記事では、Spire.Presentation for Python で OLE オブジェクトを扱う手順を紹介しました。

  1. 埋め込む — AppendOleObject() にファイルのストリームと矩形を渡し、SubstituteImagePictureFillFormat でアイコンを指定します。
  2. 種類を示す — ProgId に Excel.Sheet.12 などを設定します。
  3. 取り出す — isinstance(shape, IOleObject) で判定し、Data を保存します。
  4. 削除する — 一覧に集めてから Shapes.Remove() に渡します。

埋め込みと抽出をスクリプトにしておけば、毎月の資料を同じ構成で作り直せます。音声や動画の埋め込みは Python で PowerPoint ドキュメントの音声と動画を追加・抽出する方法 で扱っています。全機能を評価したい場合は、30 日間の無料ライセンスを申請 できます。


7. FAQ

リンクとして貼るのと、埋め込むのはどう違いますか?

埋め込むとファイルの中身が pptx に入るため、元のファイルを移動しても資料は開けます。リンクとして貼る場合は元のファイルを参照するので、受け取った側の環境にファイルが必要です。配布用の資料には埋め込みが向いています。

Excel や Word が入っていない環境でも開けますか?

OLE オブジェクトとして埋め込まれたファイル自体は pptx の中に残るため、抽出して取り出せます。編集するには対応するアプリケーションが必要ですが、資料として配る分には問題ありません。

挿入できるファイルの種類は決まっていますか?

ProgId で種類を指定するため、Excel・Word・PDF・ZIP のほか、ProgId を持つファイルであれば同じ手順で埋め込めます。ProgId が分からない場合は、既存の pptx から IOleObject.ProgId を読むと確認できます。

スライドに表示されるアイコンを変えられますか?

SubstituteImagePictureFillFormat.Picture.EmbedImage に別の画像を渡すと、スライド上の見た目が変わります。挿入後に差し替えることもできます。

画像やテキストだけを取り出したい場合は?

OLE オブジェクトではなく、画像そのものを取り出す方法は Python を使用して PowerPoint プレゼンテーションから画像を抽出する で解説しています。テキストや図形も含めて中身を確認したい場合は Python で PowerPoint ファイルを読み込む が参考になります。

Read 14 times