【実務・中級編】【初心者向け】アクティブドキュメント内の全ページを一括走査し、ページ名と用紙サイズの一覧をテキストログとして出力する – CorelDRAW VBA解析バイブル

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

【プロフェッショナル・アーキテクトの視点】CorelDRAW VBAにおけるドキュメント監査の極意:堅牢な全ページ走査の実装

「とりあえず、ループで回して中身を表示させればいい」――もし君が開発現場でそう考えているなら、そのコードは数週間後のバグ報告によって、君の信頼を失墜させることになるだろう。

今回扱うテーマは、一見すると初心者向けに見える「全ページのページ名と用紙サイズをログ出力する」という極めてシンプルなものだ。しかし、実務レベルのツール、つまり「業務を止めない、エラーで落ちない、誰が使っても同じ結果を出す」プロダクションコードを目指すならば、そこには設計思想の差が明確に現れる。

本記事では、単なるコードの書き方ではなく、CorelDRAWのオブジェクトモデルをどのように制御し、いかにして「堅牢な監査ツール」へと昇華させるかを伝授する。

1. 初心者が陥る「3つの致命的な設計ミス」

実装に入る前に、設計レベルで避けるべき罠を整理しておこう。これを知っているかどうかが、スクリプトエンジニアとアーキテクトの境界線だ。

① ユニット(単位)の不確定性

CorelDRAWのプロパティ(`Width`, `Height`)は、「その時ドキュメントに設定されている単位」を返却する。ユーザーがインチ設定ならインチ、ミリ設定ならミリが返る。ログ出力に単位の明示がない、あるいは単位を考慮していないコードは、データとしての価値がゼロだ。

② オブジェクトの存在確認(Null参照)の欠如

`ActiveDocument` が存在しない状態でコードを実行すれば、即座にランタイムエラーが発生し、アプリケーションは沈黙する。多人数が利用する環境や、自動バッチ処理の一部として組み込む場合、この「ガード句」の欠如は致命的だ。

③ ユーザー設定の破壊

サイズを取得するために、コード内でドキュメントの単位設定を書き換えてしまう実装がある。実行後にユーザーの作業環境(単位設定)が変わってしまうツールは、プロフェッショナルの仕事ではない。「状態を変更したら、必ず元に戻す」。これが鉄則だ。

2. プロダクション・クオリティの設計指針

我々が目指すのは、以下の要件を満たすコードである。

1. 冪等性(べきとうせい)の確保: どのようなドキュメント状態でも、同じロジックで安全に動作すること。
2. 副作用の最小化: ユーザーのドキュメント設定(単位など)を、実行前後で完全に一致させること。
3. 構造化された出力: 後続の解析(Excelへの貼り付けなど)が容易な、整理されたテキスト形式。

3. 実装例:堅牢なドキュメント監査スクリプト

以下に、これら全ての設計思想を詰め込んだコードを示す。これをそのままコピペして動かすことも可能だが、まずはコメントを読み、「なぜこう書いているのか」を理解してほしい。

Option Explicit

''' <summary>
''' アクティブドキュメント内の全ページ情報を監査し、イミディエイトウィンドウにログ出力する。
''' 設計思想: 単位の不確定性を排除し、ユーザー環境への副作用を最小限に抑える。
''' </summary>
Public Sub AuditDocumentPages()
    Dim doc As Document
    Dim pg As Page
    Dim originalUnit As cdrUnit
    Dim logBuffer As String
    Dim pageCount As Long
    Dim i As Long

    ' --- 1. ガード句: ドキュメントの存在確認 ---
    If Documents.Count = 0 Then
        MsgBox "監査対象のドキュメントが開かれていません。", vbCritical, "エラー"
        Exit Sub
    End If

    Set doc = ActiveDocument
    
    ' エラーハンドリングの開始
    On Error GoTo ErrorHandler

    ' --- 2. 環境の保護: 現在の単位を退避 ---
    ' ユーザーが設定している単位を壊さないよう、実行前に保存しておく。
    originalUnit = doc.Unit

    ' --- 3. 処理の正規化: 単位をミリメートルに強制固定 ---
    ' ログの信頼性を担保するため、内部処理をミリメートルに統一する。
    doc.Unit = cdrMillimeter

    ' ログのヘッダー作成
    logBuffer = "--- Document Audit Log ---" & vbCrLf
    logBuffer = logBuffer & "File: " & doc.FileName & vbCrLf
    logBuffer = logBuffer & "Total Pages: " & doc.Pages.Count & vbCrLf
    logBuffer = logBuffer & "--------------------------" & vbCrLf
    logBuffer = logBuffer & "Index | Page Name | Width (mm) | Height (mm)" & vbCrLf

    ' --- 4. ページ走査ループ ---
    pageCount = doc.Pages.Count
    For i = 1 To pageCount
        Set pg = doc.Pages(i)
        
        ' 構造化されたフォーマットで文字列を構築
        ' Format関数を用いて、数値の桁数を揃えることで視認性を高める
        logBuffer = logBuffer & Format(i, "00") & "    | " & _
                    PadString(pg.Name, 15) & " | " & _
                    Format(pg.SizeWidth, "0.00") & "      | " & _
                    Format(pg.SizeHeight, "0.00") & vbCrLf
    Next i

    logBuffer = logBuffer & "--------------------------" & vbCrLf
    logBuffer = logBuffer & "Audit Completed at " & Now

    ' --- 5. 結果の出力 ---
    ' イミディエイトウィンドウへ出力
    Debug.Print logBuffer
    
    ' ユーザーへの通知(規模が大きい場合は不要だが、完了報告として有用)
    MsgBox "ドキュメント監査が完了しました。イミディエイトウィンドウを確認してください。", vbInformation, "完了"

CleanUp:
    ' --- 6. 環境の復元: 重要 ---
    ' 処理が終わったら、必ずユーザーが元の単位設定に戻せるようにする。
    If Not doc Is Nothing Then
        doc.Unit = originalUnit
    End If
    Exit Sub

ErrorHandler:
    MsgBox "予期せぬエラーが発生しました。" & vbCrLf & _
           "Error Number: " & Err.Number & vbCrLf & _
           "Description: " & Err.Description, vbCritical, "実行時エラー"
    Resume CleanUp
End Sub

''' <summary>
''' 文字列の視認性を高めるためのパディング用関数
''' </summary>
Private Function PadString(ByVal txt As String, ByVal length As Integer) As String
    If Len(txt) >= length Then
        PadString = txt
    Else
        PadString = txt & Space(length - Len(txt))
    End If
End Function

4. コードの深層解剖:なぜこの書き方が「強い」のか

状態管理(State Management)の徹底

`originalUnit = doc.Unit` から始まり、`doc.Unit = originalUnit` で終わる。この「保存・変更・復元」のサイクルこそが、業務自動化におけるプロトコルの基本だ。これがないツールは、使えば使うほどユーザーの作業環境を汚染する「毒」となる。

文字列構築の戦略

`Debug.Print` をループ内で何度も呼び出すのは非効率だ。今回のコードでは `logBuffer` という変数に文字列を蓄積し、最後に一括で出力している。これは、将来的にログの出力先を「テキストファイル」や「データベース」に変更したくなった際、出力ロジック(`Debug.Print` の部分)を差し替えるだけで済む、「関心の分離」を意識した設計だ。

堅牢なエラーハンドリング

`On Error GoTo ErrorHandler` を使い、エラーが発生しても必ず `CleanUp` セクション(環境の復元)を経由するように設計している。これにより、エラーで止まったとしても、ユーザーのドキュメント単位が変わってしまうという最悪の事態を防いでいる。

5. 次のステップへ:実務への応用

この基礎をマスターした君には、次のような拡張を検討してほしい。

  • CSV出力への拡張: `logBuffer` の区切り文字を `,` に変え、`FileSystemObject` を使ってファイルに書き出す。これにより、監査結果をそのままExcelで集計できる。
  • ガイド線情報の取得: `pg.Guides` コレクションを走査し、各ページのガイド線の座標もログに含める。
  • オブジェクトの存在チェックの自動化: ページ内の特定のレイヤーや、特定の名前を持つオブジェクトが存在するかどうかのチェック機能を組み込む。

自動化エンジニアの仕事は、「動くものを作る」ことではない。「運用に耐えうる、信頼の仕組みを作る」ことだ。このコードの背後にある思想を、君の次のプロジェクトに刻み込んでほしい。

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