【テクニカル・上級編】【上級】Visioのステンシル読み込みを「非同期処理」で実装し、UIのフリーズを回避する – Visio VBA解析バイブル

スポンサーリンク
スポンサーリンク

【極限の設計】Visio VBAにおけるステンシル・ロードの非同期化:UIフリーズを打破するサイドカー・アーキテクチャの構築

エンジニア諸君、今日もレガシーな資産と、それ以上に厄介な「シングルスレッドの呪縛」と戦っていることだろう。

Visioの自動化において、多くの開発者が最初に直面し、そして多くが妥協する壁がある。それが「大規模ステンシルの読み込みによるUIの完全沈黙」だ。数千のマスターシェイプを含むエンタープライズ向けステンシルを `Application.Documents.OpenStencil` でロードした瞬間、Visioは「応答なし」の白濁した画面へと変貌する。

多くの者はここで `DoEvents` を挿入するという、小手先の、そして極めて不完全な手段で誤魔化そうとする。だが、それは解決ではない。単に「フリーズしている間、OSに描画の隙を与えているだけ」に過ぎない。真にプロフェッショナルなアーキテクトが求めるのは、ユーザー体験を損なわない、数学的に正しい非同期的な実行制御である。

本稿では、VBAの限界を認め、その限界をWindows APIとプロセス分離によって突破する、極限の設計パターンを解説する。

1. なぜ `DoEvents` では足りないのか:STAの限界

VBAは STA (Single-Threaded Apartment) モデルで動作している。つまり、VisioのメインUIスレッドと、君が書いたVBAの実行スレッドは、物理的に同一の糸(スレッド)で繋がっている。

`DoEvents` を呼び出せば、一時的にWindowsのメッセージキューを処理し、描画を更新することは可能だ。しかし、ステンシルのロードという重いI/O処理が走っている間、CPUはその命令の完了を待ち続けている。メッセージキューを処理する「隙間」はあっても、計算資源の大部分はブロックされたまま、ユーザーのクリック操作はキューに溜まり続け、最終的にはアプリケーションの破綻を招く。

真の非同期化を実現するには、「重い処理をメインスレッドから物理的に引き剥がす」という、設計思想の転換が必要不可欠だ。

2. 設計パターン:サイドカー・プロセス・アーキテクチャ

VBA単体でスレッドを生成することは不可能だ。したがって、我々が取るべき戦略は「サイドカー(Sidecar)パターン」である。

1. Main Process (Visio/VBA): ユーザーインターフェースと、最終的な結果の描画を担当。
2. Worker Process (VB.NET / C# / Python): ステンシルの解析、大量のマスターシェイプのメタデータ抽出、あるいは重いI/O処理を独立したプロセスとして実行。

これら二つのプロセス間を、Windows API(Named PipesやWMI、あるいは軽量な共有ファイル/レジストリ)で疎結合に連携させる。

実装のフロー

1. VBAから外部プロセスを `CreateProcess` API で非同期に起動。
2. VBA側は `MsgWaitForMultipleObjects` を用いて、プロセス終了を待ちながらもUIのメッセージループを回し続ける。
3. 外部プロセスが完了後、VBAが結果を受け取り、ステンシル操作を完結させる。

3. 実装コード:Windows APIによる非ブロッキング・プロセス監視

以下に、外部プロセスを起動し、その完了を「UIをフリーズさせずに」監視する高度な実装例を示す。ここでは、ステンシルのロード自体を外部で行うのではなく、「重い準備作業(メタデータ生成等)を外部で行わせ、完了を待つ」というシナリオを想定する。

Option Explicit

' --- Windows API Declarations ---
Private Declare PtrSafe Function CreateProcess Lib "kernel32" Alias "CreateProcessA" ( _
    ByVal lpApplicationName As String, ByVal lpCommandLine As String, _
    ByVal lpProcessAttributes As LongPtr, ByVal lpThreadAttributes As LongPtr, _
    ByVal bInheritHandles As Long, ByVal dwCreationFlags As Long, _
    ByVal lpEnvironment As LongPtr, ByVal lpCurrentDirectory As String, _
    ref lpStartupInfo As STARTUPINFOA, ref lpProcessInformation As PROCESS_INFORMATION) As Long

Private Declare PtrSafe Function MsgWaitForMultipleObjects Lib "user32" ( _
    ByVal nCount As Long, ByRef lpHandles As Any, ByVal bWaitAll As Long, _
    ByVal dwMilliseconds As Long, ByVal dwFlags As Long) As Long

Private Declare PtrSafe Function CloseHandle Lib "kernel32" (ByVal hObject As LongPtr) As Long

' --- Constants ---
Private Const CREATE_NO_WINDOW As Long = 0x08000000
Private Const MWMO_ALERTABLE As Long = 0x00000001
Private Const WAIT_OBJECT_0 As Long = 0

' --- Structures ---
Private Type STARTUPINFOA
    cb As Long
    lpReserved As String
    lpDesktop As String
    lpTitle As String
    dwX As Long
    dwY As Long
    dwXSize As Long
    dwYSize As Long
    dwXCountChars As Long
    dwYCountChars As Long
    dwFillAttribute As Long
    dwFlags As Long
    wShowWindow As Integer
    wFlags As Integer
    w कोतНастроек As Integer
    cbReserved2 As Integer
    lpReserved2 As String
End Type

Private Type PROCESS_INFORMATION
    hProcess As LongPtr
    hThread As LongPtr
    dwProcessId As Long
    dwThreadId As Long
End Type

''' <summary>
''' 非同期的に外部プロセスを実行し、UIをフリーズさせずに完了を待機する
''' </summary>
Public Sub ExecuteAsynchronousTask(ByVal commandLine As String)
    Dim si As STARTUPINFOA
    Dim pi As PROCESS_INFORMATION
    Dim ret As Long
    Dim handles(0 To 0) As LongPtr
    
    si.cb = LenB(si)
    
    ' プロセスの起動
    ' CREATE_NO_WINDOW を指定することで、バックグラウンドで静かに実行させる
    ret = CreateProcess(vbNullString, commandLine, 0, 0, 0, CREATE_NO_WINDOW, 0, vbNullString, si, pi)
    
    If ret = 0 Then
        MsgBox "プロセス起動に失敗しました。", vbCritical
        Exit Sub
    End If
    
    handles(0) = pi.hProcess
    
    Debug.Print "Worker Process Started. PID: " & pi.dwProcessId
    
    ' --- 非ブロッキング・ループ ---
    ' MsgWaitForMultipleObjects を使用することで、プロセス終了を待ちつつ、
    ' Windowsメッセージ(描画、クリック等)を処理する機会を確保する。
    Do
        ' 100ms待機。MWMO_ALERTABLEにより、待機中にメッセージを処理可能にする
        ret = MsgWaitForMultipleObjects(1, handles(0), 0, 100, MWMO_ALERTABLE)
        
        Select Case ret
            Case WAIT_OBJECT_0
                ' プロセスが終了した
                Debug.Print "Worker Process Completed."
                Exit Do
                
            Case Else
                ' メッセージが発生した、あるいはタイムアウト
                ' ここでDoEventsを呼ぶ必要はない。MsgWaitForMultipleObjectsが
                ' メッセージキューを適切に処理する。
                DoEvents 
        End Select
        
        ' UIへのフィードバック(プログレスバーの更新など)をここで行う
        ' ユーザーに「動いていること」を伝えるのがプロの作法だ。
        Application.StatusBar = "外部プロセス実行中... " & Format(Timer, "0.0")
    Loop
    
    ' 後処理:ハンドルは必ず解放せよ。これを怠ればリソースリークの元だ。
    CloseHandle pi.hProcess
    CloseHandle pi.hThread
    
    Application.StatusBar = False
    MsgBox "全工程が完了しました。", vbInformation
End Sub

4. メモリ最適化とオブジェクトのライフサイクル

非同期処理において、最も危険なのは「プロセスの境界を越えたオブジェクト参照」だ。

VBA側で生成したオブジェクトを外部プロセスに渡そうとする、あるいはその逆を行う際、COMの参照カウント(Reference Counting)が狂い、メモリリーク、あるいは「オブジェクトが使用中のため操作できません」という致命的なエラーを引き起こす。

アーキテクトの鉄則:

1. データの受け渡しは「値」で行え:
オブジェクトそのものをやり取りしようとするな。JSON、XML、あるいは単純なCSVとしてシリアライズし、ファイルまたはパイプ経由で渡せ。これが最も堅牢で、デバッグも容易な方法だ。
2. 明示的な解放(Explicit Release):
VBAのガベージコレクションは、君が期待するほど賢くない。特に、ループ内でステンシルやマスターシェイプを操作する場合、`Set obj = Nothing` は必須だ。

Dim st As Visio.Stencil
    Set st = Application.Documents.OpenStencil("LargeStencil.vssx")
    ' ... 処理 ...
    st.Close
    Set st = Nothing ' これを忘れると、Visioプロセスがメモリに居座り続ける

3. COMのデッドロックを回避せよ:
外部プロセスがVisioのオブジェクトモデルを操作する場合(COM Automation)、Visioがメインスレッドで何らかのダイアログ(保存確認など)を出していると、外部プロセスは永遠にブロックされる。外部プロセスを設計する際は、常に「VisioがUIスレッドを占有している可能性」を考慮し、タイムアウト処理を組み込むこと。

5. 結論:レガシーを支配する者へ

Visio VBAの自動化は、単なるスクリプト作成ではない。それは、Windowsという巨大なOSの挙動を理解し、制限の中で最大限のパフォーマンスを引き出すシステムエンジニアリングである。

`DoEvents` で逃げるのか、それともWindows APIとプロセス分離を用いて、堅牢なアーキテクチャを構築するのか。その選択が、君の作るシステムの格を決める。

大量のマスターシェイプに怯える必要はない。プロセスを分離し、メッセージループを制御し、メモリを管理せよ。それが、極限の知見を備えたエンジニアの歩むべき道だ。

タイトルとURLをコピーしました