【実務・中級編】【中級者】スライド内のすべてのテキストボックスからフォント名を抽出し、社内標準フォントへ一括置換してから別名保存するフォントマネージャー – PowerPoint VBA解析バイブル

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

【極限の知見】PowerPoint VBAにおける「フォント一括置換」の設計論:再帰処理とオブジェクト階層を制する

クライアントから納品されたPowerPointファイルを開いた瞬間、デザイナーが血の涙を流す光景を、君は何度見てきただろうか?

「MS Pゴシック」「游ゴシック」「Arial」「Helvetica」……。スライドごとに、あるいはテキストボックスごとにバラバラに混在したフォント群。これを目視で修正するなど、プロフェッショナルの仕事ではない。自動化すべきだ。

しかし、多くの「自称・自動化エンジニア」が書くコードは、あまりにも脆弱だ。
`For Each shp In sld.Shapes` とループを回し、`shp.TextFrame.TextRange.Font.Name = “Standard Font”` と一行書くだけ。そんなコードは、グループ化された図形や表(Table)、あるいはSmartArtに遭遇した瞬間に、ランタイムエラーを吐いて沈黙する。

本記事では、単なる「動くコード」ではなく、実務の現場で耐えうる「堅牢なフォントマネージャー」を構築するための設計思想と、その極致となる実装コードを伝授する。

1. なぜ君のコードは「壊れる」のか:オブジェクト階層の罠

PowerPointのオブジェクトモデルは、単なる平坦なリストではない。それは「階層構造を持つツリー」だ。

陥りがちな3つの設計ミス

1. グループ化(GroupShapes)の無視
図形がグループ化されている場合、`Shapes`コレクションの直下にテキストフレームは存在しない。グループの中にある「子要素」の `Shapes` を再帰的に探索しなければ、置換漏れが発生する。
2. 表(Tables)の看過
`Shape` オブジェクトが `HasTable` プロパティを持つ場合、テキストは `TextFrame` ではなく、`Table.Cell(r, c).Shape.TextFrame` の中に存在する。これを忘れると、表の中のフォントは放置される。
3. エラーハンドリングの欠如
テキストを持たない図形(線や単純な画像)に対して `TextFrame` にアクセスしようとすれば、即座に実行時エラーが発生する。`On Error Resume Next` で誤魔化すのは、エンジニアとしての敗北だ。

2. アーキテクチャ設計:再帰的探索と責任の分離

堅牢なツールを作るためには、「探索(Traversal)」と「置換(Replacement)」の責務を分離すべきだ。

  • メインルーチン: ファイルの読み込み、保存、全体の進行管理。
  • 再帰的探索ルーチン: 図形が単体か、グループか、表かを判別し、末端のテキスト保持オブジェクトまで潜り込む。
  • 置換エンジン: ターゲットとなるオブジェクトに対し、安全にフォントを適用する。

3. プロダクション・コード:FontManager Module

以下に、そのまま実務投入可能なレベルのコードを示す。このコードは、グループ化された図形、表、および標準的なテキストボックスを網羅し、エラーを回避しながら確実にフォントを書き換える。

Option Explicit

' ==============================================================================
' Module: FontManager
' Description: スライド内の全テキストのフォントを社内標準へ一括置換する
' Author: Chief Architect
' ==============================================================================

Private Const TARGET_FONT As String = "游ゴシック" ' 置換後の標準フォント名

''' <summary>
''' メインエントリーポイント
''' </summary>
Public Sub ExecuteFontReplacement()
    Dim pres As Presentation
    Dim sld As Slide
    Dim shp As Shape
    Dim savePath As String
    
    Set pres = ActivePresentation
    
    ' 1. 実行確認
    If MsgBox("現在のプレゼンテーションの全フォントを '" & TARGET_FONT & "' に置換しますか?" & vbCrLf & _
              "※別名で保存されます。", vbQuestion + vbYesNo) <> vbYes Then Exit Sub

    On Error GoTo ErrorHandler
    
    ' 2. 高速化のための設定(描画更新停止)
    ' ※PowerPoint VBAにはExcelのScreenUpdatingのような直接的なプロパティがないため、
    '   処理の重い操作を最小限にする設計が必要。
    
    Debug.Print "--- Font Replacement Started ---"

    ' 3. 全スライドの走査
    For Each sld In pres.Slides
        For Each shp In sld.Shapes
            ' 再帰的に図形を処理(グループ化対応)
            ProcessShape shp
        Next shp
    Next sld

    ' 4. 別名保存(元のファイルを破壊しないための鉄則)
    savePath = pres.Path & "\" & Left(pres.Name, InStrRev(pres.Name, ".") - 1) & "_Standardized.pptx"
    pres.SaveCopyAs savePath
    
    MsgBox "処理が完了しました。" & vbCrLf & "保存先: " & savePath, vbInformation
    Exit Sub

ErrorHandler:
    MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
End Sub

''' <summary>
''' 図形を解析し、適切なテキスト要素へ辿り着く再帰関数
''' </summary>
''' <param name="shp">解析対象のShapeオブジェクト</param>
Private Sub ProcessShape(ByRef shp As Shape)
    Dim i As Integer, r As Integer, c As Integer
    Dim gShp As Shape

    On Error Resume Next ' 個別の図形エラーで全体を止めないための局所的トラップ

    Select Case shp.Type
        Case msoGroup
            ' --- ケース1: グループ化された図形 ---
            ' 再帰呼び出しにより、グループ内の全子要素を走査する
            For Each gShp In shp.GroupItems
                ProcessShape gShp
            Next gShp

        Case msoTable
            ' --- ケース2: 表(Table) ---
            ' 表はセルごとにShapeが存在するため、二重ループで走査
            For r = 1 To shp.Table.Rows.Count
                For c = 1 To shp.Table.Columns.Count
                    ApplyFontToTextRange shp.Table.Cell(r, c).Shape.TextFrame.TextRange
                Next c
            Next r

        Case msoPlaceholder, msoTextBox, msoAutoShape
            ' --- ケース3: 通常のテキスト保持図形 ---
            If shp.HasTextFrame Then
                If shp.TextFrame.HasText Then
                    ApplyFontToTextRange shp.TextFrame.TextRange
                End If
            End If
            
        ' その他の型(SmartArt等)は、必要に応じてここに追加拡張する
    End Select

    On Error GoTo 0
End Sub

''' <summary>
''' 実際にフォントを適用する低レイヤー関数
''' </summary>
''' <param name="tr">対象のTextRangeオブジェクト</param>
Private Sub ApplyFontToTextRange(ByRef tr As TextRange)
    ' TextRange全体に対してフォントを適用
    ' 文字ごとにフォントが異なる場合でも、この一括指定で統一される
    tr.Font.Name = TARGET_FONT
    ' 日本語フォントと英字フォントの両方を確実に指定
    tr.Font.NameFarEast = TARGET_FONT
End Sub

4. プロフェッショナルのための「設計の勘所」

このコードを単にコピペして終わらせてはいけない。実務で運用する際には、以下の3点を意識せよ。

① `NameFarEast` の重要性

PowerPointのフォントオブジェクトには、`Name`(英字用)と `NameFarEast`(東アジア言語用)の2種類が存在する。ここを疎かにすると、英数字は変わるが日本語が元のフォントのまま残るという、中途半端な結果を招く。必ず両方をセットで制御せよ。

② `SaveCopyAs` による安全性確保

業務自動化ツールにおいて、「元のファイルを上書きする」という設計は極めてリスクが高い。処理中にエラーが起きたり、予期せぬフォントの変化が起きた際、ユーザーは元に戻せなくなる。必ず `SaveCopyAs` を使い、加工済みのファイルを別名で生成する設計を徹底せよ。

③ 拡張性(Scalability)への配慮

今回は `Select Case` 文を用いて、図形のタイプ別に処理を分岐させている。今後、「SmartArt内のテキストも置換したい」「グラフ内のテキストも対象にしたい」という要件が出た場合、この `ProcessShape` 内に新しい `Case` を追加するだけで済む。これが「疎結合な設計」の恩恵だ。

結論

優れた自動化ツールとは、単に「速い」ものではない。「例外的なデータ(イレギュラーな階層構造)に対しても、エレガントに、かつ安全に振る舞う」ものだ。

君が次にコードを書くときは、目の前の `Shape` が「単なる図形」なのか、それとも「複雑な階層を持つオブジェクトの入り口」なのかを、常に問い続けなさい。それが、エンジニアと、ただのスクリプターを分かつ境界線である。

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