【入門編】【中級】マスターシェイプの「保護設定」をVBAで一括解除し、編集後に再ロックする安全なフロー – Visio VBA解析バイブル

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

【極限の知見】マスターシェイプの「保護」を制御する:エラーを恐れない安全な一括更新フロー

こんにちは。現場の自動化エンジニアとして、日々複雑な図面生成やプロセス管理の設計を行っているアーキテクトです。

「マクロの記録」を使って、ようやく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は劇的にプロフェッショナルなものになります。

「もっと深く知りたい」「このエラーはどう対処すべき?」といった疑問があれば、いつでも挑戦し続けてください。コードの向こう側にある、美しい設計を目指して。

応援していますよ!

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