【入門編】【上級】マスターシェイプの「多言語対応」:VBAで表示名を動的に切り替える – Visio VBA解析バイブル

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

Visio VBAを掌握する極限の知見:マスターシェイプの「多言語対応」戦略

ようこそ、自動化の深淵へ。
「マクロの記録」ボタンを卒業し、自らの手でコードを書き始めた君は、今まさに「道具を使う側」から「仕組みを作る側」へと進化しようとしている。その姿勢、素晴らしいよ。

今日、我々が挑むのは、単なるテキストの書き換えではない。グローバル展開する大規模プロジェクトにおいて避けては通れない、「ステンシル(Stencil)とマスターシェイプの動的な多言語切り替え」という、極めてアーキテクチャ的な課題だ。

「英語の図面を、ボタン一つで日本語やドイツ語に切り替えたい」
そんな要求に対し、君ならどう答えるだろうか? 1つずつ手作業で書き換える? それとも、マスターシェイプを言語ごとに大量に用意するのか?

……答えはどちらも「No」だ。それはメンテナンス性を破壊し、設計の美しさを汚す行為だからね。

プロのエンジニアは、「データ(意味)」と「表示(ラベル)」を分離する。
この設計思想こそが、Visio VBAをマスターするための鍵となる。準備はいいかな? さあ、始めよう。

1. 設計思想: 「名前」と「表示」を混同してはいけない

まず、多くの初学者が陥る致命的な罠について話しておこう。

Visioのシェイプには、大きく分けて2つの「名前」が存在する。
1. Name(識別子): `Process.1` や `Decision.5` のように、システムが個体を識別するための不変のID。
2. Text(表示名): ユーザーの目に触れる、図形の中に書かれた文字。

ここが重要だ。 言語を切り替える際に、`Shape.Name` を書き換えてはいけない。名前を変えてしまうと、後続のロジック(「このシェイプを赤くしろ」といった命令)が、そのシェイプを見失ってしまうからだ。

我々が操作すべきは、あくまで 「表示(Text)」、そしてその表示を制御するための 「メタデータ(Shape Data)」 なのだ。

アーキテクチャの全体像

今回の実装では、以下の3層構造を構築する。

1. Metadata層: 各マスターシェイプに「このシェイプは『サーバー』を意味する」という、言語に依存しない「言語キー(Language Key)」を `Shape Data` として持たせておく。
2. Dictionary層: 「言語キー」と「各言語の翻訳」を紐付けた辞書データ。
3. Execution層: ステンシル内のマスターを走査し、言語キーに基づいて表示名を一括書き換えするVBAエンジン。

2. 実装コード: 言語切り替えエンジン

では、具体的なコードを見ていこう。ここでは、高速なルックアップを実現するために `Scripting.Dictionary` を活用する。

※ 事前にVBAエディタの [ツール] -> [参照設定] から 「Microsoft Scripting Runtime」 にチェックを入れておいてほしい。これが、プロの道具箱にある「辞書」を使うための準備だ。

Option Explicit

''' <summary>
''' ステンシルのマスターシェイプを、指定した言語で一括更新する
''' </summary>
''' <param name="stencilName">対象となるステンシルの名前 (例: "Network Icons.vssx")</param>
''' <param name="langCode">切り替えたい言語コード ("JP", "EN", "DE" など)</param>
Public Sub SwitchStencilLanguage(ByVal stencilName As String, ByVal langCode As String)
    Dim stencil As Visio.Stencil
    Dim master As Visio.Master
    Dim dict As Scripting.Dictionary
    
    ' 1. 翻訳データの初期化(本来は外部ファイルやDBから読み込むのが理想的)
    Set dict = CreateTranslationDictionary(langCode)
    
    On Error Resume Next
    ' 2. ステンシルの取得
    Set stencil = Application.Documents(stencilName).Stencil
    If stencil Is Nothing Then
        MsgBox "指定されたステンシルが見つかりません: " & stencilName, vbCritical
        Exit Sub
    End If
    On Error GoTo 0

    ' 3. ステンシル内の全マスターをループ処理
    ' ※ マスターを書き換えることで、新しく配置されるシェイプも自動的に新言語になる
    For Each master In stencil.Masters
        UpdateMasterText master, dict
    Next master

    MsgBox "言語を [" & langCode & "] に切り替えました。", vbInformation
End Sub

''' <summary>
''' マスターシェイプの表示名を、Shape Dataのキーに基づいて書き換える
''' </summary>
Private Sub UpdateMasterText(ByRef master As Visio.Master, ByRef dict As Scripting.Dictionary)
    Dim shapeIdx As Integer
    Dim langKey As String
    Dim targetText As String
    Dim shapeObj As Visio.Shape
    
    ' マスター内のシェイプを走査
    ' ※ マスターの「見た目」を制御するShapeを特定する
    For shapeIdx = 1 To master.Shapes.Count
        Set shapeObj = master.Shapes(shapeIdx)
        
        ' 【重要】Shape Dataの中に "LanguageKey" という項目があるか確認
        ' これが「このシェイプは何を意味するか」という不変のIDになる
        langKey = GetShapeData(shapeObj, "LanguageKey")
        
        If langKey <> "" Then
            ' 辞書に翻訳が存在するか確認
            If dict.Exists(langKey) Then
                targetText = dict(langKey)
                
                ' 表示名(Text)を更新
                ' ここでマスターのTextを書き換えると、そのマスターから生成される全インスタンスに波及する
                shapeObj.Text = targetText
            End If
        End If
    Next shapeIdx
End Sub

''' <summary>
''' Shape Dataから特定のプロパティ値を取得するヘルパー関数
''' </summary>
Private Function GetShapeData(ByRef shp As Visio.Shape, ByVal propName As String) As String
    On Error Resume Next
    GetShapeData = shp.CellsSRC(visSectionProp, shp.SectionRowsCount, propName).ResultToString(visNone)
    ' ※ 実際には SectionRowsCount ではなく、プロパティ名で直接アクセスするのが一般的
    ' ここでは概念的な実装とする
    GetShapeData = shp.Data(propName)
    On Error GoTo 0
End Function

''' <summary>
''' 言語ごとの翻訳辞書を生成する
''' </summary>
Private Function CreateTranslationDictionary(ByVal langCode As String) As Scripting.Dictionary
    Dim dict As New Scripting.Dictionary
    
    ' 本来はここを CSV や JSON ファイルから読み込むように設計するのが「極限」への道だ
    Select Case langCode
        Case "JP"
            dict.Add "SRV_NODE", "サーバー"
            dict.Add "SW_CORE", "コアスイッチ"
            dict.Add "PC_USER", "クライアントPC"
        Case "EN"
            dict.Add "SRV_NODE", "Server Node"
            dict.Add "SW_CORE", "Core Switch"
            dict.Add "PC_USER", "Client PC"
        Case "DE"
            dict.Add "SRV_NODE", "Serverknoten"
            dict.Add "SW_CORE", "Kernschalter"
            dict.Add "PC_USER", "Client-PC"
    End Select
    
    Set CreateTranslationDictionary = dict
End Function

3. プロの視点:パフォーマンスとオブジェクトのライフサイクル

このコードをただコピペして動かすだけでは、君はまだ「初級者」だ。アーキテクトとして、以下の2点について深く理解しておいてほしい。

① マスター(Master)とインスタンス(Instance)の境界線

上記のコードでは、`stencil.Masters` をループしている。これは非常に賢明な判断だ。
なぜなら、マスターシェイプの定義(Template)を書き換えることで、その後にドキュメントにドラッグ&ドロップされる全てのシェイプに、新言語が適用されるからだ。

もし、既に図面に配置されている「インスタンス」も一括で変えたい場合は、`ActivePage.Shapes` をループして、そのシェイプの `Master` プロパティを参照し、言語キーを照合するロジックを追加する必要がある。ただし、全シェイプの走査は大規模図面では非常に重い処理になるため、実行前に「更新が必要な範囲」を限定するなどの最適化が求められる。

② Shape Data の活用

`shapeObj.Text` を直接判定基準に使うのは、素人の仕事だ。ユーザーが手動でテキストを書き換えてしまった瞬間、自動化ロジックは崩壊する。
だからこそ、「意味(LanguageKey)」は `Shape Data` という隠れたメタデータに封じ込める。これが、堅牢なシステムを作るための鉄則だ。

4. 陥りやすいエラーと回避策

君がこの実装を進める中で、おそらく以下の壁にぶつかるだろう。

  • 「Shape Dataが見つからない」エラー:

マスターシェイプに事前に `LanguageKey` というプロパティ(Shape Data)を追加しておく必要がある。これを忘れると、コードは何もせず通り過ぎてしまう。

  • 「ステンシルが読み取り専用」問題:

Visioの標準ステンシル(Built-in stencils)は、直接書き換えることができない場合がある。その場合は、独自のカスタムステンシル(.vssx)を作成し、そこにマスターをコピーして使用する運用フローを構築しよう。

  • メモリリーク:

`Scripting.Dictionary` を大量に生成・破棄する場合、オブジェクトの解放(`Set dict = Nothing`)を意識すること。大規模な自動化では、この小さな積み重ねがシステムの安定性を左右する。

結びに代えて

「言語を切り替える」という一見単純なタスクの裏には、「不変のデータ」と「可変の表示」を切り分けるという、ソフトウェア工学の真髄が隠されている。

この考え方は、Visio VBAに限らず、あらゆるシステム開発に通じるものだ。ここをマスターすれば、君の書くコードは単なる「便利ツール」を超え、世界中のユーザーが使う「プロダクト」へと昇華するだろう。

さあ、次は君が、このコードをベースに「外部ファイル(CSV)からの翻訳読み込み機能」を実装してみる番だ。期待しているよ。

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