openpyxlでActiveXボタンを扱う方法（ヒント：LegacyDrawing）

はじめに：openpyxlとActiveXボタン、その奇妙な関係
結論：ボタンの「操作」は不可能。しかし「共存」はできる
手がかりLegacyDrawingの正体とは？
実践：LegacyDrawingを手がかりにActiveXボタンを扱うコード
1. Step 1: 調査対象のファイルを用意する
2. Step 2: Pythonでファイルを調査し、ボタンと共存する
ボタンを「操作」したい場合の代替策
1. 策1：pywin32ライブラリ（Windows限定）
2. 策2：自動化プロセスの見直し
まとめ：LegacyDrawingは灯台のようなもの

はじめに：openpyxlとActiveXボタン、その奇妙な関係

Pythonのopenpyxlライブラリは、セルの値を読み書きするのには最適です。しかし、一度シート上に配置されたActiveXのコマンドボタンを扱おうとすると、途端に情報が見つからなくなり、多くの開発者が頭を悩ませます。

「openpyxlで、このボタンの存在をどうやって知ればいいんだ？」「ボタンを消さずにファイルだけ更新したい…」

実は、その謎を解く鍵はws.legacy_drawingという、あまり目立たない属性に隠されています。この記事では、このLegacyDrawingを手がかりに、openpyxlがActiveXボタンをどのように認識し、我々がそれをどう扱うべきかという問いに答えていきます。

結論：ボタンの「操作」は不可能。しかし「共存」はできる

最初に核心をお伝えします。openpyxlを使って、ActiveXボタンをクリックしたり、キャプションを変えたりといった「操作」はできません。 しかし、LegacyDrawingの存在を理解することで、ボタンを破壊せずにファイルの内容を更新し、「共存」する方法が見えてきます。

openpyxlはExcelファイルの中身（XML）を直接編集するライブラリです。Excelアプリケーションそのものを動かすわけではないため、ボタンクリックのような動的なイベントは扱えないのです。

手がかりLegacyDrawingの正体とは？

では、ヒントとして提示したLegacyDrawingとは一体何者なのでしょうか？

これは「レガシー（旧式）の描画オブジェクト」を意味し、openpyxlが直接理解できない複雑なオブジェクトがシート上に存在するとき、その存在を示す痕跡として現れます。

ActiveXコントロールは、まさにこの「openpyxlには理解できないオブジェクト」の代表例です。したがって、

ws.legacy_drawingにオブジェクトが存在する＝そのシートにはActiveXコントロールや古い図形などが存在する可能性が高い

という重要な手がかりになるのです。ただし、これはあくまで存在を示すだけで、このオブジェクトを通してボタンのプロパティにアクセスすることはできません。

実践：LegacyDrawingを手がかりにActiveXボタンを扱うコード

言葉だけでは分かりにくいので、実際のコードで動きを追ってみましょう。

Step 1: 調査対象のファイルを用意する

まず、手動でActiveXボタンを配置したExcelファイルを用意します。

Excelを起動し、「開発」タブを開きます。
「挿入」→「ActiveX コントロール」から「コマンドボタン」を選び、シート上に配置します。
このファイルを「button_test.xlsm」という名前で、マクロ有効ブックとして保存します。

Step 2: Pythonでファイルを調査し、ボタンと共存する

次に、このファイルをopenpyxlで読み込み、legacy_drawingの存在を確認した上で、セルの値だけを更新して保存してみます。

from openpyxl import load_workbook

FILE_PATH = "button_test.xlsm"

try:
    # ActiveXボタンやVBAを保持するため、keep_vba=True は必須！
    wb = load_workbook(FILE_PATH, keep_vba=True)
    ws = wb.active

    print(f"シート '{ws.title}' の調査を開始...")

    # 手がかり(legacy_drawing)の存在を確認
    if ws.legacy_drawing:
        print(f"発見！このシートには 'LegacyDrawing' の痕跡があります。")
        print("→ ActiveXボタンなどのオブジェクトが存在する可能性が高いです。")
    else:
        print("このシートに 'LegacyDrawing' の痕跡は見つかりませんでした。")
        
    # ボタンには触らず、セルの値だけを更新する
    ws['A1'] = f"最終更新: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}"
    print("\nA1セルの値を更新しました。")
    
    # 新しいファイルとして保存
    new_file_path = "button_test_updated.xlsm"
    wb.save(new_file_path)
    print(f"ファイルを '{new_file_path}' として保存しました。")

except FileNotFoundError:
    print(f"エラー: 調査対象ファイル '{FILE_PATH}' が見つかりません。")

このコードを実行後、button_test_updated.xlsmを開いてみてください。A1セルの値が更新されている一方で、コマンドボタンは元の位置にそのまま残っているはずです。これがopenpyxlで実現できる「共存」です。