【入門編】【初心者】ステンシル読み込み時に発生する「既に開かれています」エラーをVBAでスマートに回避する – Visio VBA解析バイブル

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

もうエラーに怯えない。Visio VBAで「ステンシル二重読み込み」をスマートに回避する技術

こんにちは。Visio VBAの世界へようこそ。

マクロの記録機能を使って、「あ、これ自動化できそうだな」と一歩踏み出したあなた。素晴らしいセンスです。しかし、記録されたコードをそのまま実行して、「実行時エラー:既に開かれています」という無機質なメッセージに突き当たって、少しガッカリしていませんか?

実は、そのエラーこそが「単なる記録者」から「エンジニア」へと脱皮するための最初の扉なのです。

今日は、このエラーの正体を解き明かし、プロが現場で使う「ステンシル(型紙)をスマートに管理する手法」を伝授します。ここをクリアすれば、あなたの作るツールは格段に安定し、信頼されるものになりますよ。

1. なぜ「既に開かれています」エラーが起きるのか?

まず、敵を知ることから始めましょう。

Visioにおいて、ステンシル(Stencil)は特別な種類の「ドキュメント(Document)」として扱われます。あなたがマクロで「このステンシルを開け」と命令したとき、Visioは律儀にその指示に従おうとします。

しかし、もしそのステンシルが既にVisioのメモリ上に開かれていたらどうなるでしょうか?

Visioは「えっ、もうそこにあるのに、新しく開けって言うの? どうすればいいかわからないよ!」と混乱し、エラーを吐き出してしまうのです。

「マクロの記録」の限界

マクロの記録は、「何をしたか」は教えてくれますが、「その時、どんな状態だったか」までは判断してくれません。

  • マクロの記録: 「ステンシルAを開け!」(状態を問わない命令)
  • エンジニアのコード: 「ステンシルAは今開いているかな? 開いていないなら開こう。開いているなら、それを使おう。」(状態を判断するロジック)

この「状態を判断する」というプロセスこそが、自動化における「安全性」の正体です。

2. 解決の鍵は「Documentsコレクション」にある

エラーを回避するための戦略はシンプルです。
「命令を出す前に、既に開いていないか確認する」。これだけです。

Visioには、現在開いているすべてのドキュメント(図面やステンシル)を管理する `Application.Documents` という「リスト(コレクション)」が存在します。このリストの中身を一つずつチェックして、目的のステンシル名が見つかるかどうかを確認すればいいのです。

3. 実践:スマートなステンシル取得関数

それでは、実際のコードを見ていきましょう。
単にエラーを回避するだけでなく、「ステンシルが開いていればそれを返し、開いていなければ新しく開いて返す」という、非常に再利用性の高い「関数(Function)」の形で作ります。

これを一度作っておけば、あなたの他のプログラムでも使い回すことができますよ。

''**
'' 関数名:GetOrCreateStencil
'' 概要  :指定した名前のステンシルが既に開いていればそれを返し、
''          開いていなければ新しく開いて返す。
'' 引数  :stencilName (String) - 開きたいステンシルのファイル名(例: "Basic Shapes.vssx")
'' 戻り値:Visio.Document - 対象のステンシルオブジェクト
''**
Function GetOrCreateStencil(stencilName As String) As Visio.Document
    Dim doc As Visio.Document
    Dim isFound As Boolean
    
    isFound = False
    
    ' 1. 現在開いているすべてのドキュメントをループで確認する
    ' Application.Documents は、現在Visioが認識している全ての「ファイル」のリストです
    For Each doc In Application.Documents
        ' ステンシルの名前が一致するか判定(大文字小文字を区別しないように比較)
        If StrComp(doc.Name, stencilName, vbTextCompare) = 0 Then
            ' 一致するものが見つかった!
            isFound = True
            Exit For ' ループを抜ける
        End If
    Next doc
    
    ' 2. 見つかった場合と見つからなかった場合の処理
    If isFound Then
        ' 既に開いているので、そのドキュメントをそのままセット
        Set GetOrCreateStencil = doc
    Else
        ' 開いていないので、新しくオープンする
        ' ※ここでエラーが出る場合は、ファイルパスが正しいか確認してください
        On Error GoTo ErrorHandler
        Set GetOrCreateStencil = Application.Documents.Open(stencilName)
    End If
    
    Exit Function

ErrorHandler:
    MsgBox "ステンシル '" & stencilName & "' を開けませんでした。" & vbCrLf & _
           "ファイル名が正しいか、パスが通っているか確認してください。", vbCritical
    Set GetOrCreateStencil = Nothing
End Function

''**
'' メインルーチン:動作テスト用
''**
Sub TestStencilLoading()
    Dim myStencil As Visio.Document
    Dim targetName As String
    
    ' テストしたいステンシル名を指定(拡張子まで含めるのが確実です)
    targetName = "Basic Shapes.vssx"
    
    ' 先ほど作った関数を呼び出す
    Set myStencil = GetOrCreateStencil(targetName)
    
    ' 取得に成功したかチェック
    If Not myStencil Is Nothing Then
        MsgBox "ステンシル '" & myStencil.Name & "' を正常に準備できました!", vbInformation
        ' ここに、ステンシルからシェイプを配置する処理などを書いていきます
    Else
        MsgBox "ステンシルの準備に失敗しました。", vbExclamation
    End If
End Sub

4. コードの重要ポイント解説

このコードには、プロの現場で必須となる「作法」がいくつか盛り込まれています。

① `StrComp` による安全な比較

`If doc.Name = stencilName` と書いても動きますが、私はあえて `StrComp(…, vbTextCompare)` を使っています。これは、「大文字と小文字の違いを無視して比較する」という指定です。
人間が「Basic Shapes」と書いても、コンピュータが「basic shapes」と認識していても、同じものとして扱ってくれる。この「遊び(ゆとり)」が、エラーを防ぐ堅牢なコードを作ります。

② `Nothing` による失敗の通知

もしステンシルが見つからず、開くことにも失敗した場合、関数は `Nothing`(空っぽの状態)を返します。
呼び出し側の `If Not myStencil Is Nothing Then` という一文は、「準備がちゃんとできた時だけ、次の作業に進む」という防波堤の役割を果たしています。

③ モジュール化(Function化)

「開く」という処理を `Sub`(命令)ではなく `Function`(値を生む関数)にしたのが最大のポイントです。これにより、メインのプログラムは「どうやって開くか」という細かい手順を知る必要がなくなり、「ステンシルをちょうだい」と頼むだけで済むようになります。これを「カプセル化」と呼び、複雑なプログラムを整理する基本テクニックです。

5. まとめ:ここをクリアすれば、もう一歩先へ

「既に開かれています」というエラーは、決してあなたを拒絶しているわけではありません。
「今の状態をちゃんと確認してから動いてね」という、Visioからの親切なアドバイスなのです。

今回学んだ「コレクションをループして存在確認を行う」という手法は、Visio VBAに限らず、あらゆるプログラミング言語における「オブジェクト管理」の基本中の基本です。

1. 探す(Loop through Collection)
2. 判断する(If exists…)
3. 実行する(Open or Use existing)

このリズムを身につければ、あなたの自動化ツールは、どんな状況下でもスマートに、そして力強く動き続けるでしょう。

ここをクリアしたあなたは、もう「マクロの記録」の域を完全に脱しています。自信を持って、次の自動化に挑戦してください。応援していますよ!

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