もうエラーに怯えない。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)
このリズムを身につければ、あなたの自動化ツールは、どんな状況下でもスマートに、そして力強く動き続けるでしょう。
ここをクリアしたあなたは、もう「マクロの記録」の域を完全に脱しています。自信を持って、次の自動化に挑戦してください。応援していますよ!
