最近、私が所属するデジタル戦略支援事業部でAI博覧会というイベントに出展しておりました。
私は弊社の出展ブースでディスプレイに流すPowerPointの準備をしていたのですが、スライドショーのページが切り替わるたびロボットにスライド内容を話してもらうことになりました。
（来場していただいた方には「あーあれか」と分かってもらえると思います）
その中でPythonを使ってPowerPointのイベント処理をするプログラムを実装しましたので、勉強したこと等含めてまとめさせていただきたいと思います。
(ロボットに話してもらうことについてはまたどこかの記事でまとめられればと思っています。)

さっそくですが、今回実装したプログラムについての説明です。

PowerPointのスライドショー表示において、以下のタイミングで標準出力にメッセージが表示されるプログラムとなります。

• スライドショーが始まったとき：「SlideShow Started」
• スライドショーを終了したとき：「SlideShow Ended」
• スライドショーのページが切り替わったとき：「Slide Changed: {切り替え後のスライド番号}, Notes: {切り替え後のスライドのノート内容}」

実装にはpywin32というPythonライブラリを利用します。
このライブラリによってPythonからWin32 APIを呼び出せるようになります。

最初にpywin32を以下のコマンドでインストールしてください。

pip install pywin32

実装コードは以下です。

import pythoncom
import win32com.client
from time import sleep

class PowerPointEventHandler:
    def __init__(self):
        self.current_slide_index = None

    def OnSlideShowBegin(self, Wn):
        print("SlideShow Started")
        self.current_slide_index = None

    def OnSlideShowEnd(self, Pres):
        print("SlideShow Ended")
        self.current_slide_index = None

    def send_slide_info(self, Wn):
        slide_index = Wn.View.CurrentShowPosition
        if slide_index > 0 and slide_index != self.current_slide_index:
            self.current_slide_index = slide_index
            print(slide_index)
            slide = Wn.Presentation.Slides(slide_index)
            try:
                notes_text = slide.NotesPage.Shapes.Placeholders(2).TextFrame.TextRange.Text
            except Exception as e:
                notes_text = f"No notes, error: {e}"
            message = f"Slide Changed: {slide_index}, Notes: {notes_text}"
            print(message)

def main():
    powerpoint = win32com.client.DispatchWithEvents("PowerPoint.Application", PowerPointEventHandler)
    print("Monitoring PowerPoint events...")

    event_handler = PowerPointEventHandler()

    while True:
        pythoncom.PumpWaitingMessages()
        try:
            slide_show_windows = powerpoint.SlideShowWindows
            if slide_show_windows.Count > 0:
                slide_show_window = slide_show_windows(1)
                event_handler.send_slide_info(slide_show_window)
            else:
                event_handler.__init__()
        except Exception as e:
            print(f"Error: {e}")
        sleep(0.5)

if __name__ == "__main__":
    main()

上記のコードについて、とくにpywin32を用いた主要な処理について説明をしていきたいと思います。

Win32 APIやCOMについて何も知らない状態から勉強したので、まとめている内容に間違いがあるかもしれませんが参考程度にお読みいただけると幸いです。

• pythoncom : OLE(Object Linking and Embedding)オートメーションAPIを利用するためのモジュールです^[1]。今回のプログラムでは発生したイベントの処理実行するために使います。
• win32com.client : COMクライエントを作成・利用するためのモジュールです^[2]。COMはOLEの基盤技術であり、COMクライアントからOLEのイベントをハンドリングできます。今回のプログラムではPowerPointのイベントハンドリングするCOMオブジェクトを作成するために使います。

このクラスはPowerPointのイベントをハンドリングするためのものです。特にスライドショーの開始、終了、ページ変更に関連するイベントを処理します。

• OnSlideShowBegin: スライドショーが開始した際に呼び出されるイベントハンドラメソッドです。
• OnSlideShowEnd: スライドショーが終了した際に呼び出されるイベントハンドラメソッドです。
• send_slide_info: 現在表示されているスライドの情報を取得して出力します。スライドのインデックスを取得し、前回のスライドと異なる場合にそのスライド番号とノートの内容を表示します。
  （とある事情により上記2つのイベントハンドラとは違ってmain関数上で明示的な呼び出しをします。事情に関しては下記。）

イベントハンドラとするメソッド名にはルールがあり、処理したいイベント名の先頭にOnを付けた名前にする必要があります。
今回の最初2つのハンドラのメソッド名もそれに倣い、PowerPoint.Applicationオブジェクトが持つイベント名の先頭にOnを付けた名前としています。

PowerPoint.Applicationオブジェクトに他にもどんなイベントがあるか、イベントの引数名やデータ型は何かなどの仕様を以下ページから確認できます。

アプリケーション オブジェクト (PowerPoint)#イベント

•  powerpoint = win32com.client.DispatchWithEvents("PowerPoint.Application", PowerPointEventHandler)
  

このコードではPowerPoint.Applicationオブジェクトを作成し、PowerPointEventHandlerをイベントハンドラとして登録します。これにより、起動中のPowerPointでイベントが発生すると、このクラスの対応するメソッドが呼び出されるようになります。^[3]

PowerPoint.Applicationオブジェクトが持つメソッドやプロパティは以下をご参照ください
アプリケーション オブジェクト (PowerPoint)

• pythoncom.PumpWaitingMessages()
  

このコードでは、待機中のイベントを実行します。^[4][5]
今回のプログラムではスライドショーの開始と終了イベントが発生したときにハンドラメソッド内の処理が実行されるようになります。

• 残りの処理は、スライドショーで表示中のページ位置を取得して、ページの切り替えがあるとそのページのインデックスやノートを取得して出力する処理を無限ループするものになります。
  PowerPoint.Applicationオブジェクトのプロパティを調べ方がわかっていれば特別難しいことはないかなと思うので説明は以上です。

今回、PowerPointのイベント処理をpywin32を用いて実装しました。
Win32 APIやCOMなどWindowsで古くから用いられている技術について個人的に少しだけ理解が進んだかなと思います。
今回のプログラムは最初にベースだけChatGPTに書いてもらいました。pywin32をまったく触ったことのなかった状態の私にとって大きな時間の短縮になりとても助かりました。

• Python for Win32 Extensions Help
• Wikipedia-Component Object Model
• Wikipedia-Object Linking and Embedding
• COMクライアントとCOMサーバーについて