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

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

マクロ記録の先へ。ドキュメントの「構造」を可視化する——ページ監査の極意

こんにちは。CorelDRAW VBAの世界へようこそ。

「マクロの記録」ボタンを押して、自分が操作した手順がコードとして書き出されるのを見て、「おぉ、魔法みたいだ!」と感じたことはありませんか? それは素晴らしい第一歩です。しかし、もしあなたが「もっと複雑なことを自動化したい」「決まったルールで大量のページを処理したい」と願うなら、その「記録されたコード」という魔法の杖を一度置いて、オブジェクトの構造という真実に向き合う時が来ました。

今日は、プロフェッショナルな業務自動化への登竜門として、「ドキュメント内の全ページを走査(スキャン)し、その情報をログとして書き出す」というテクニックを伝授します。

これは単なる情報の表示ではありません。設計図(ドキュメント)が今どうなっているのかを、エンジニアの視点で「監査(Audit)」する、極めて重要なプロセスなのです。

1. なぜ「全ページ走査」が必要なのか?

実務において、数百ページに及ぶカタログや、複雑なレイアウトが重なるドキュメントを扱う場面は多々あります。

「全てのページのサイズが、意図した通りになっているか?」
「ページ名に規則性はあるか?」

これを目視で確認するのは、時間がかかるだけでなく、人間特有の「見落とし」というリスクを伴います。VBAを使えば、一瞬で、かつ正確に、ドキュメントの「健康診断」を行うことができます。

この「中身を一つずつ確認していく作業(走査)」をマスターすれば、特定のページだけに処理を行う、あるいはページごとに異なる処理を割り当てるといった、高度な自動化への道が拓けます。

2. CorelDRAWの階層構造(オブジェクトモデル)を理解する

コードを書く前に、CorelDRAWがどのような「親子関係」で成り立っているかを知っておきましょう。ここを理解していないと、コードはただの呪文になってしまいます。

CorelDRAWの階層は、大まかに以下のようになっています。

1. Application(CorelDRAWそのもの)
2. Document(今開いているファイル)
3. Page(ファイルの中にある各ページ)
4. Layer / Shape(ページの中にあるレイヤーや図形)

今回の目的は、「Document」の中にある「Page」という集合体(コレクション)を、一つずつ順番に見ていくことです。

3. 実践:全ページ情報を出力するコード

では、実際に動くコードを見てみましょう。初心者の方でも迷わないよう、丁寧にコメントを添えました。

Option Explicit

''' <summary>
''' アクティブなドキュメント内の全ページを走査し、
''' ページ名と用紙サイズをイミディエイトウィンドウに出力する。
''' </summary>
Sub AuditDocumentPages()
    ' --- 変数の宣言 ---
    ' Pageオブジェクト:ページを一つずつ指し示すための変数
    Dim pg As Page
    ' Documentオブジェクト:操作対象のドキュメントを指すための変数
    Dim doc As Document
    
    ' --- 事前チェック ---
    ' ドキュメントが開かれていない場合にエラーにならないようガードをかける
    If Documents.Count = 0 Then
        MsgBox "開いているドキュメントが見つかりません。", vbExclamation
        Exit Sub
    End If

    ' 現在アクティブなドキュメントを変数にセット
    Set doc = ActiveDocument

    ' --- ログ出力のヘッダー ---
    Debug.Print "--- [Document Audit Start] ---"
    Debug.Print "Document Name: " & doc.Name
    Debug.Print "Total Pages: " & doc.Pages.Count
    Debug.Print "--------------------------------------------"

    ' --- ページ走査のメインループ ---
    ' For Each 文を使うことで、ページが何枚あっても自動的に最初から最後まで繰り返します
    For Each pg In doc.Pages
        
        ' ページ名、幅、高さを取得してイミディエイトウィンドウへ出力
        ' ※ doc.Unit を指定することで、現在のドキュメントの単位で取得できます
        ' ※ 単位を分かりやすくするために、ここでは width と height を取得
        
        Debug.Print "Page #" & pg.Index & " | Name: " & pg.Name & _
                    " | Size: " & Format(pg.SizeWidth, "0.00") & " x " & _
                    Format(pg.SizeHeight, "0.00") & " (" & GetUnitName(doc.Unit) & ")"
                    
    Next pg

    ' --- 終了処理 ---
    Debug.Print "--------------------------------------------"
    Debug.Print "--- [Document Audit Completed] ---"
    
    ' 完了をユーザーに知らせる(大量なページがある場合は、メッセージボックスは不要かもしれません)
    MsgBox "ドキュメントの監査が完了しました。イミディエイトウィンドウを確認してください。", vbInformation
End Sub

''' <summary>
''' 単位の数値(Constant)を、読みやすい文字列に変換する補助関数
''' </summary>
Private Function GetUnitName(u As cdrUnit) As String
    Select Case u
        Case cdrMillimeter: GetUnitName = "mm"
        Case cdrCentimeter: GetUnitName = "cm"
        Case cdrInch:       GetUnitName = "in"
        Case cdrPixel:      GetUnitName = "px"
        Case Else:          GetUnitName = "unknown"
    End Select
End Function

4. コードの重要ポイント解説

① `For Each pg In doc.Pages` の魔法

ここが今回の心臓部です。`doc.Pages` は、ドキュメントに含まれるすべてのページを束ねた「コレクション」です。
`For Each` を使うことで、「ページが1枚なら1回、100枚なら100回、中身を `pg` という変数に入れて繰り返す」という動きを、枚数を気にせず実現できます。これが「マクロの記録」にはない、プログラミングの柔軟性です。

② `Debug.Print` と「イミディエイトウィンドウ」

結果を画面上のメッセージボックスに出すと、ページ数が多い場合に何枚分もクリックしなければならず大変です。
そこで使うのが `Debug.Print`。これは、VBAエディタ内にある「イミディエイトウィンドウ」(表示されていない場合は `Ctrl + G` で出せます)に、テキストとして結果を流し込む命令です。開発中のログ出力において、エンジニアが最も多用する武器の一つです。

③ 単位(Unit)の罠を回避する

ここが、プロとアマチュアを分ける境界線です。
CorelDRAWの内部では、サイズは数値として持っていますが、「それがmmなのか、inchなのか」という情報は `doc.Unit` に紐付いています。
上記のコードでは、`GetUnitName` という補助関数を作り、今どの単位で表示されているかをログに添えるようにしました。これがないと、「幅が 297 だ」と言われても、それが mm なのか inch なのか判断できず、監査として機能しません。

5. 陥りやすいエラーと対策

このコードを試す際、以下の点に注意してください。

1. ドキュメントが何も開かれていない状態
`ActiveDocument` を参照しようとした瞬間にエラーになります。コード内の `If Documents.Count = 0` というチェックが、それを防ぐための「プロの作法」です。
2. 単位の不一致
もし、特定の単位(例えば常にmm)で出力したい場合は、`pg.SizeWidth` を取得する前に、一時的に `doc.Unit = cdrMillimeter` と設定するか、値を変換する計算式を入れる必要があります。

最後に:ここをクリアすれば、次は「操作」です

お疲れ様でした! これであなたは、ドキュメントの構造を読み解く「監査」の術を手にしました。

「中身を知る(読み取る)」ことができれば、次は「中身を書き換える(操作する)」ことが容易になります。
「もし、ページ名が ‘Cover’ だったら、サイズを A3 に変更する」
「もし、高さが 200mm 未満のページがあったら、警告を出す」

そんな風に、「条件(If)」と「走査(For Each)」を組み合わせることで、あなたの自動化プログラムは生命を宿し、真の力を発揮します。

一歩ずつ、確実に。CorelDRAW VBAの深淵を楽しみながら進んでいきましょう。応援していますよ!

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