【入門編】【上級プロ向け】存在しないレイヤーや不正な座標指定を完全ガード!Err.Number捕捉とログ出力メカニズムの堅牢なエラーハンドリング – CorelDRAW VBA解析バイブル

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

「マクロが止まる」を過去にする。CorelDRAW VBAで極限の堅牢性を実現するエラーハンドリング術

こんにちは。現場の自動化を支えるエンジニアの皆さん。
CorelDRAWのマクロ記録機能を使って、「お、動いた!」と喜んだ経験は誰にでもあるはずです。でも、そのマクロを実務のルーチンワークとして、あるいはお客様に渡すツールとして運用し始めたとき、こんな恐怖に襲われませんでしたか?

「昨日まで動いていたのに、レイヤー構成が少し変わっただけで、突然エラーで止まってしまった……」

これは、あなたが「マクロ(記録)」から「プログラム(設計)」へとステップアップするための、非常に重要な境界線です。

今日は、プロの現場で求められる「例外を完全にコントロールし、プログラムを死なせない」ための、堅牢なエラーハンドリングとログ出力のメカニズムについて、魂を込めて解説します。

1. なぜ、あなたのマクロは「突然」死ぬのか?

CorelDRAW VBAの世界で、エラーが発生する原因は大きく分けて2つあります。

① オブジェクトのライフサイクル問題(存在しないものへのアクセス)

VBAは非常に素直です。例えば、`ActivePage.Layers(“Layer1”)` と書いたとき、もしユーザーが手動で “Layer1” を削除していたら? VBAは「そんなものはない!」と叫んで、その瞬間に処理を停止します。
マクロ記録は「今そこにあるもの」を前提にコードを書きますが、実務では「あるはずのものが、あるとは限らない」という前提で設計しなければなりません。

② 数値の境界値問題(不正な座標指定)

ガイド線を自動配置する際、計算式を使って座標を算出することがあります。しかし、計算ミスやデータの不備で「数値が無限大(Infinity)」になったり、「極端に大きな値」になったりすると、CorelDRAWのAPIはエラーを返します。

これらを放置すると、マクロは「実行時エラー」を表示して止まり、それまでの作業が中途半端な状態で残ってしまいます。これはプロの仕事としては許されません。

2. プロの設計思想:3つの柱

堅牢なツールを作るために、私たちは以下の3つの設計思想を導入します。

1. 「Try-Catch-Finally」思想の導入: エラーが起きることを前提とし、起きた時に「どこで」「何が」起きたかを捕捉する。
2. ガード節(Guard Clauses): APIを叩く前に、「そのレイヤーはあるか?」「その数値は妥当か?」を事前にチェックする。
3. 中央集権型ログ出力: エラーを画面にポップアップさせるだけでなく、テキストファイルに詳細を書き出し、後から「なぜ失敗したか」を検証可能にする。

3. 実践:堅牢なエラーハンドリング・テンプレート

それでは、実際に現場でそのまま使えるレベルのコードを書いてみましょう。
単なるコードの提示ではなく、「なぜこう書くのか」という意図を読み取ってください。

' ============================================================
' モジュール名: RobustAutomationModule
' 概要: エラーに強く、ログを出力するプロ仕様の自動化テンプレート
' ============================================================

Option Explicit

' ログファイルのパス(実行ファイルと同じフォルダに保存する想定)
Private Const LOG_FILE_PATH As String = "Automation_Log.txt"

''' <summary>
''' メイン処理:レイヤーの追加とガイド線の配置
''' </summary>
Public Sub ExecuteRobustProcess()
    Dim targetLayer As Layer
    Dim targetLayerName As String
    Dim guideX As Double
    
    targetLayerName = "Production_Layer"
    
    ' --- [1. エラーハンドリングの開始] ---
    On Error GoTo ErrorHandler
    
    ' 画面更新を停止してパフォーマンスを向上(プロの定石)
    Optimization = True
    ActiveDocument.BeginCommandGroup "Robust Process"

    ' --- [2. ガード節:レイヤーの存在確認と安全な取得] ---
    ' 直接アクセスせず、関数を介して「安全に」取得する
    Set targetLayer = GetLayerSafe(targetLayerName)
    
    If targetLayer Is Nothing Then
        ' レイヤーがない場合は作成する(エラーにせず、リカバリを行う)
        Set targetLayer = ActivePage.CreateLayer(targetLayerName)
        WriteLog "INFO: Layer '" & targetLayerName & "' was missing. Created a new one."
    End If

    ' --- [3. ガード節:不正な座標の防止] ---
    ' 本来は複雑な計算の結果が入る想定
    guideX = CalculateSafeCoordinate() 
    
    If IsValidCoordinate(guideX) Then
        ' 安全が確認できてからAPIを呼び出す
        ActivePage.Guides.Add cdrGuideHorizontal, guideX
        WriteLog "SUCCESS: Guide added at X=" & guideX
    Else
        ' 不正な数値の場合は、エラーとしてログを残し、処理をスキップする
        Err.Raise vbObjectError + 513, "CoordinateCheck", "Invalid coordinate calculated: " & guideX
    End If

    ' --- [4. 正常終了処理] ---
    ActiveDocument.EndCommandGroup
    Optimization = False
    MsgBox "処理が正常に完了しました。", vbInformation
    Exit Sub

' --- [5. エラーハンドリング・セクション] ---
ErrorHandler:
    ' 画面更新を必ず元に戻す(これを忘れるとCorelDRAWの挙動がおかしくなる)
    Optimization = False
    If Not ActiveDocument Is Nothing Then ActiveDocument.EndCommandGroup
    
    ' エラー内容を詳細にログ出力
    Dim errorMsg As String
    errorMsg = "ERROR #" & Err.Number & " [" & Err.Source & "]: " & Err.Description
    WriteLog errorMsg
    
    ' ユーザーには簡潔なメッセージのみを表示
    MsgBox "予期せぬエラーが発生しました。詳細はログを確認してください。" & vbCrLf & _
           "Error: " & Err.Description, vbCritical, "Automation Error"
End Sub

' ============================================================
' ヘルパー関数(ここがエンジニアの腕の見せ所)
' ============================================================

''' <summary>
''' レイヤーを安全に取得する関数
''' </summary>
Private Function GetLayerSafe(ByVal layerName As String) As Layer
    On Error Resume Next ' エラーを無視して次へ
    Set GetLayerSafe = ActivePage.Layers(layerName)
    On Error GoTo 0 ' エラーハンドリングを元に戻す
End Function

''' <summary>
''' 座標が妥当(有限かつ範囲内)かチェックする関数
''' </summary>
Private Function IsValidCoordinate(ByVal val As Double) As Boolean
    ' 数値が極端に大きすぎたり、エラー値(NaNなど)でないかを確認
    ' ここでは例として、CorelDRAWの作業領域を想定した範囲チェックを行う
    If IsEmpty(val) Or IsError(val) Then
        IsValidCoordinate = False
    ElseIf val > 100000 Or val < -100000 Then ' 範囲は要件に合わせて調整
        IsValidCoordinate = False
    Else
        IsValidCoordinate = True
    End If
End Function

''' <summary>
''' 座標計算のシミュレーション(あえてエラーを起こすパターンも想定)
''' </summary>
Private Function CalculateSafeCoordinate() As Double
    ' ここでは例として固定値を返すが、実務では計算式が入る
    CalculateSafeCoordinate = 50.0 
End Function

''' <summary>
''' 詳細なログをテキストファイルに書き出す関数
''' </summary>
Private Sub WriteLog(ByVal message As String)
    Dim fileNum As Integer
    Dim logEntry As String
    
    fileNum = FreeFile
    ' タイムスタンプを付与
    logEntry = Now & " | " & message
    
    ' ファイルを追記モードで開く
    Open LOG_FILE_PATH For Append As #fileNum
    Print #fileNum, logEntry
    Close #fileNum
End Sub

4. コードの深層解説:なぜこれで「最強」なのか

🛡️ `On Error Resume Next` の「正しい」使い方

初心者は、エラーが出ると怖くなって、コードの冒頭に `On Error Resume Next` を書いてしまいがちです。これは「エラーを無視して突き進む」という自殺行為です。

私のコードを見てください。`GetLayerSafe` 関数の中だけで、限定的に使用しています。
「レイヤーを探して、なければ `Nothing` を返す」という目的のためだけに、一時的にエラーを黙らせているのです。これこそが、制御されたエラーハンドリングです。

🛡️ `Optimization` と `CommandGroup` の重要性

`Optimization = True` は、描画処理を止めてスピードを爆速にします。しかし、途中でエラーが起きて止まると、CorelDRAWの画面が更新されず、操作不能に見えることがあります。
`ErrorHandler` 内で必ず `Optimization = False` に戻す。これは、ユーザーの作業環境を守るためのエンジニアの義務です。

🛡️ ログ出力による「事後検証」の実現

プログラムが止まったとき、ユーザーは「何が起きたか」を知りたがります。
`WriteLog` 関数によって、`2023/10/27 10:00:00 | ERROR #513: Invalid coordinate…` といった記録が残れば、あなたは開発環境に戻って、その数値がなぜ発生したのかを正確にデバッグできます。

5. まとめ:ここをクリアすれば、あなたはもう「プロ」です

マクロを記録する段階から、「もし、ここでエラーが起きたらどうするか?」を考え、コードを組む段階へ。
この思考の転換こそが、単なる「マクロ使い」と「自動化エンジニア」を分ける決定的な違いです。

1. オブジェクトの存在を疑え。
2. 計算結果の妥当性を疑え。
3. エラーは「隠す」のではなく「記録」せよ。

この3点を守るだけで、あなたの作るツールは劇的に信頼性を増します。
さあ、このテンプレートを自分のプロジェクトに取り入れて、世界に一つだけの、絶対に止まらない堅牢な自動化システムを構築していきましょう!

応援していますよ。

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