【極限の知見】マスターシェイプの「保護」を制御する:エラーを恐れない安全な一括更新フロー
こんにちは。現場の自動化エンジニアとして、日々複雑な図面生成やプロセス管理の設計を行っているアーキテクトです。
「マクロの記録」を使って、ようやくVisioの操作を自動化できた……。そう感じているあなた。素晴らしい一歩です。でも、実務で「プロのツール」として通用するコードを書くためには、もう一段階上のフェーズへ進む必要があります。
今日扱うテーマは、「マスターシェイプの保護設定の一括解除と、安全な再ロック」です。
一見、単純な「プロパティの書き換え」に見えますよね? しかし、ここに「オブジェクトのライフサイクル」と「エラーハンドリングの設計」という、エンジニアとしての腕の見せ所が詰まっています。
ここをクリアすれば、あなたのVisio VBAは「動くコード」から「信頼されるシステム」へと進化しますよ。さあ、一緒に見ていきましょう。
1. なぜ「マスターシェイプ」の操作は危険なのか?
まず、概念を整理しましょう。Visioにおける「マスターシェイプ」と、図面上に配置された「インスタンス(シェイプ)」は別物です。
- マスターシェイプ: ステンシルの中に眠る「設計図」。
- インスタンス: 設計図を元に、図面上に実体化した「製品」。
マスターシェイプのプロパティ(色、サイズ、あるいは「保護設定」)を変更すると、そのマスターから生成されたすべてのインスタンスに影響が波及します。
もし、一括解除したままプログラムがエラーで止まってしまったらどうなるでしょうか? ユーザーが誤って図面を壊してしまう「保護されていない状態」が放置されることになります。これは業務ツールとしては致命的な欠陥です。
私たちは、「作業中だけ鍵を開け、たとえ途中で失敗しても必ず鍵を閉める」という、トランザクションのような堅牢な設計を目指す必要があります。
2. 「保護」の正体を知る:プロパティではなく「セル」である
初心者が最初につまずくのが、保護設定の操作です。
「`Shape.Locked = True`」のような直感的なプロパティは存在しません。Visioにおいて、保護設定はシェイプの「Protectionセル」という特殊なデータの中に、ビットフラグ(数値の組み合わせ)として格納されています。
| 保護したい項目 | セル内の値(ビット) |
|---|---|
| 移動 (Move) | 1 |
| サイズ変更 (Size) | 2 |
| 回転 (Rotate) | 4 |
| 削除 (Delete) | 8 |
| … | … |
これらをVBAで操作するには、セルの `Formula` プロパティに対して、特定の数値を書き込む(あるいは消す)という操作が必要になります。
3. 【実践】安全な一括更新フローの設計
それでは、プロの設計パターンをコードで見ていきましょう。
今回実装するのは、「指定したステンシル内の全マスターの保護を一時解除し、編集を行った後、再び保護をかける」というフローです。
Option Explicit
''' <summary>
''' ステンシル内のマスターシェイプの保護を一時解除し、
''' 安全に編集・再ロックを行うメインルーチン
''' </summary>
Public Sub SafeMasterUpdateProcess()
Dim stencil As Visio.Stencil
Dim master As Visio.Master
Dim targetStencilName As String
' --- 設定エリア ---
targetStencilName = "Basic Shapes" ' 対象とするステンシルの名前
' ------------------
' 1. ステンシルの取得
On Error Resume Next
Set stencil = Application.Documents.Stencil(targetStencilName)
On Error GoTo 0
If stencil Is Nothing Then
MsgBox "対象のステンシルが見つかりません: " & targetStencilName, vbCritical
Exit Sub
End If
Debug.Print "--- プロセス開始 ---"
' 2. 各マスターに対して処理を実行
' エラーハンドリングの要:各マスターごとに「try-catch」的な動きをさせる
For Each master In stencil.Masters
Call ProcessSingleMaster(master)
Next master
Debug.Print "--- 全プロセス完了 ---"
MsgBox "マスターシェイプの一括更新が完了しました。", vbInformation
End Sub
''' <summary>
''' 個別のマスターシェイプに対する「解除 → 編集 → ロック」の安全なフロー
''' </summary>
Private Sub ProcessSingleMaster(ByRef targetMaster As Visio.Master)
Dim shape As Visio.Shape
Dim originalProtection As String
' マスターシェイプ自体は「Shape」オブジェクトとして扱える
' ただし、マスターの保護設定は特殊なため、Shapeオブジェクトとしてアクセスする
On Error GoTo ErrorHandler
' --- Step 1: 現在の保護状態をバックアップ ---
' これにより、元の状態を正確に復元できる(設計の肝)
originalProtection = targetMaster.CellsU("Protection").Formula
' --- Step 2: 保護を解除 (0 をセット) ---
' すべての保護を一旦クリアする
targetMaster.CellsU("Protection").Formula = "0"
Debug.Print "Unlocked: " & targetMaster.Name
' --- Step 3: ここで実際の「編集」を行う ---
' 本来はここに、マスターの形状変更や色変更のロジックが入ります
' 今回はデモンストレーションとして、名前の末尾に日付を付与する等の処理を想定
Call PerformComplexEditing(targetMaster)
' --- Step 4: 保護を復元 ---
' 成功した場合、バックアップしておいた元の値を書き戻す
targetMaster.CellsU("Protection").Formula = originalProtection
Debug.Print "Relocked: " & targetMaster.Name
CleanExit:
Exit Sub
ErrorHandler:
' --- Step 5: エラー発生時の救済措置 ---
' 編集中にエラーが起きても、必ず「元の保護状態」に戻す
Debug.Print "Error in " & targetMaster.Name & ": " & Err.Description
targetMaster.CellsU("Protection").Formula = originalProtection
Resume CleanExit
End Sub
''' <summary>
''' 実際の編集ロジック(シミュレーション)
''' </summary>
Private Sub PerformComplexEditing(ByRef targetMaster As Visio.Master)
' ここに複雑なロジックを記述。
' 意図的にエラーを発生させてテストする場合は、以下をアンコメントしてください。
' If targetMaster.Name = "Ellipse" Then Err.Raise 999
' 例: マスターの名前を少し変更してみる(実際にはもっと複雑な操作)
' targetMaster.Name = targetMaster.Name & "_Updated"
End Sub
4. コードの解説:なぜこれが「強い」コードなのか
このコードには、初学者が一歩抜け出すための3つの重要なテクニックが組み込まれています。
① 「状態のバックアップ」という思想
`originalProtection = targetMaster.CellsU(“Protection”).Formula`
ここが最も重要です。単に「最後にロックをかける」のではなく、「作業前の状態をメモリに保存しておく」。これにより、元々「移動だけ禁止」だったシェイプを、エラー後に「すべて禁止」にしてしまうような、意図しない設定変更を防いでいます。
② 粒度の細かいエラーハンドリング
`SafeMasterUpdateProcess`(全体)の中でエラーを捕まえるのではなく、`ProcessSingleMaster`(個別のマスター)の中でエラーを捕まえています。
もし100個のマスターのうち、50個目でエラーが起きても、「失敗したマスターだけを安全に復旧し、残りの51〜100個の処理を継続する」ことができます。これが業務システムの「回復力(Resilience)」です。
③ `CellsU` プロパティの活用
`Cells` ではなく `CellsU` (Universal) を使用しています。Visioには言語によってプロパティ名が異なる場合がありますが、`CellsU` を使うことで、多言語版のVisio環境でも動作する、移植性の高いコードになります。
5. まとめ:エンジニアへの道
今回のフローをマスターすれば、あなたは単に「自動化ができる人」から、「壊れない仕組みを作れる人」へとステップアップできます。
1. マスター操作は影響範囲が広いことを自覚する。
2. 「解除 $\to$ 編集 $\to$ 復元」を一つのユニットとして設計する。
3. エラーが起きても「元の状態」を保証する仕組み(バックアップ)を持つ。
これらを意識するだけで、あなたの書くVBAは劇的にプロフェッショナルなものになります。
「もっと深く知りたい」「このエラーはどう対処すべき?」といった疑問があれば、いつでも挑戦し続けてください。コードの向こう側にある、美しい設計を目指して。
応援していますよ!
