CorelDRAW VBAを掌握する極限の知見:例外処理を「工学」として設計せよ
業務自動化の現場において、プログラミングができる人間は掃いて捨てるほどいる。しかし、「壊れないシステム」を設計できるエンジニアは極めて稀だ。
多くの開発者が陥る罠がある。それは、「自分の環境で動いたから、このコードは完成だ」という慢心だ。CorelDRAWのVBA開発において、この慢心は致命的なバグ、ひいてはユーザーの作業データ喪失という大事故を招く。
ユーザーは、君が想定していないタイミングでレイヤーを削除する。ユーザーは、外部データから読み込んだ不正な数値をガイド線の座標に放り込む。あるいは、ネットワーク越しに参照しているファイルが、一瞬の瞬断でアクセス不能になる。
本稿では、単なる `On Error Resume Next` の使い方などという初歩的な話はしない。オブジェクトのライフサイクル、座標系の整合性、そしてエラーを「情報の資産」に変えるロギングメカニズムについて、プロフェッショナルが備えるべき設計思想を伝授する。
1. なぜ、君のコードは「現場」で死ぬのか
CorelDRAWのオブジェクトモデルは、極めて動的(Dynamic)だ。これは、柔軟であると同時に、極めて不安定であることを意味する。
レイヤーの「消失」という不可避の事態
`ActiveDocument.Layers(“Production_Layer”)` と記述した瞬間、もしユーザーがそのレイヤーを削除していたらどうなるか? プログラムは即座にランタイムエラーを吐き、停止する。
「存在を確認してからアクセスする」のは基本だが、「確認してからアクセスするまでのコンマ数秒の間に、ユーザーが操作して削除する」というレースコンディション(競合状態)すら、実務の現場では起こりうるのだ。
座標系の「境界」という罠
ガイド線を自動配置する際、外部データベースやExcelから取得した数値を使用することが多い。しかし、その数値が `Double` 型の精度限界を超えていたり、ドキュメントの描画範囲(Page Bounds)を大きく逸脱していた場合、CorelDRAWのAPIは予期せぬ挙動を示すか、あるいは静かに計算エラーを引き起こす。
2. 堅牢なエラーハンドリングのアーキテクチャ
プロフェッショナルな設計では、エラーを「避けるもの」ではなく、「構造的に捕捉し、適切に処理するもの」と定義する。
我々が採用すべきは、「Try-Catch-Finally」パターンをVBA流に昇華させた構造である。
1. Try (Attempt): メインロジックの実行。
2. Catch (ErrorHandler): エラー番号(`Err.Number`)に基づいた、原因の特定と分類。
3. Finally (CleanUp): エラーの有無にかかわらず、`Optimization`(描画停止)の解除や、開いたファイルのクローズを確実に行うフェーズ。
3. 【実践】プロダクション・グレードのテンプレートコード
以下に、レイヤー操作とガイド配置を安全に行うための、そのまま実戦投入可能なクラスモジュール級の設計例を示す。
' ==============================================================================
' Module: modAutomationEngine
' Description: 堅牢なレイヤー・ガイド操作エンジン
' Author: Chief Architect
' ==============================================================================
Option Explicit
' カスタムエラー定義(エラーの性質を分類する)
Public Enum AutomationError
errNone = 0
errLayerNotFound = 1001
errInvalidCoordinate = 1002
errExternalResourceMissing = 1003
errUnknown = 9999
End Enum
''' <summary>
''' 指定したレイヤーにガイド線を安全に配置するメインルーチン
''' </summary>
Public Sub SafeGuidePlacement(ByVal targetLayerName As String, ByVal xPos As Double)
Dim targetLayer As Layer
Dim doc As Document
' 1. 環境の初期化(高速化設定)
Set doc = ActiveDocument
If doc Is Nothing Then
MsgBox "ドキュメントが開かれていません。", vbCritical
Exit Sub
End If
On Error GoTo ErrorHandler
Optimization = True ' 描画停止による高速化
EventsEnabled = False
' --- [メインロジック開始] ---
' 2. レイヤーの存在チェックと取得(生存確認)
Set targetLayer = GetLayerSafe(doc, targetLayerName)
If targetLayer Is Nothing Then
Err.Raise errLayerNotFound, "modAutomationEngine", "レイヤー '" & targetLayerName & "' が見つかりません。"
End If
' 3. 座標のバリデーション(不正な数値のガード)
If Not IsValidCoordinate(xPos, doc) Then
Err.Raise errInvalidCoordinate, "modAutomationEngine", "座標値 " & xPos & " はドキュメントの範囲外です。"
End If
' 4. ガイド線の配置実行
' ここで発生するAPIエラーもErrorHandlerが捕捉する
targetLayer.Guides.Add cdrGuideHorizontal, xPos ' 例として水平ガイド
' --- [メインロジック終了] ---
CleanUp:
' 5. 【重要】Finallyフェーズ:リソースの解放と環境の復元
' エラーが起きても起きなくても、必ず実行される
Optimization = False
EventsEnabled = True
Set targetLayer = Nothing
Set doc = Nothing
Debug.Print "Process completed safely."
Exit Sub
ErrorHandler:
' 6. Catchフェーズ:エラーの解析とログ出力
Dim errorMsg As String
errorMsg = "Error #" & Err.Number & " (" & Err.Description & ") at " & Err.Source
' ログファイルへの書き出し(実務ではここが命)
WriteErrorLog errorMsg
' ユーザーへの通知(詳細すぎる情報は隠し、アクションを促す)
Select Case Err.Number
Case errLayerNotFound
MsgBox "設定エラー: 指定されたレイヤーが見つかりません。レイヤー名を確認してください。", vbExclamation
Case errInvalidCoordinate
MsgBox "データエラー: 座標値が異常です。入力データを確認してください。", vbExclamation
Case Else
MsgBox "予期せぬエラーが発生しました。管理者にログを報告してください。", vbCritical
End Select
' 復旧処理へ
Resume CleanUp
End Sub
' ------------------------------------------------------------------------------
' Helper Functions (Private)
' ------------------------------------------------------------------------------
''' <summary>
''' レイヤーの存在を安全に確認する
''' </summary>
Private Function GetLayerSafe(ByRef doc As Document, ByVal name As String) As Layer
On Error Resume Next
Set GetLayerSafe = doc.Layers(name)
On Error GoTo 0
End Function
''' <summary>
''' 座標がドキュメントの描画可能範囲内にあるか検証する
''' </summary>
Private Function IsValidCoordinate(ByVal pos As Double, ByRef doc As Document) As Boolean
' 簡易的な実装例。実際にはPageのBoundsと比較すること
' 座標が極端な値(NaNや無限大、あるいはドキュメント外)でないか
If IsEmpty(pos) Or pos > 100000 Or pos < -100000 Then
IsValidCoordinate = False
Else
IsValidCoordinate = True
End If
End Function
''' <summary>
''' エラーログをテキストファイルに永続化する
''' </summary>
Private Sub WriteErrorLog(ByVal msg As String)
Dim logFile As String
Dim fileNum As Integer
logFile = ThisDocument.Path & "\automation_error.log"
fileNum = FreeFile
Open logFile For Append As #fileNum
Print #fileNum, Now & " | " & msg
Close #fileNum
End Sub
4. 現場で差がつく、設計の「重み」
コードを提示したが、これだけでは不十分だ。以下の3点を設計思想に組み込め。
① 外部連携(ファイル・DB)における「ロック」の考慮
データベースやCSVから座標を取得する場合、そのファイルが他のプロセスによってロックされている可能性がある。`Open` 文を使用する際は、必ずエラーハンドリングを行い、ファイルが使用中の場合は「リトライ処理」を入れるか、ユーザーに「ファイルを閉じてから再実行してください」という明確な指示を出す設計にせよ。
② Optimization(最適化)の副作用
`Optimization = True` は処理を劇的に速めるが、エラーが発生した瞬間に `False` に戻らず、CorelDRAWの描画がフリーズしたように見える現象を引き起こす。必ず `CleanUp` ラベルにおいて、状態を復元するコードを「絶対に」通るように設計すること。これが、プロとアマチュアの分水嶺だ。
③ ログは「後から追える」ものであるべき
`MsgBox` はユーザーへの通知には良いが、原因究明には役立たない。本稿のコード例にあるように、`WriteErrorLog` を通じて、「いつ」「どの関数で」「どんなエラー番号が」発生したかをタイムスタンプと共にファイルに残せ。これが、保守コストを劇的に下げる唯一の方法だ。
結論
堅牢な自動化ツールとは、単に「動くもの」ではない。「予期せぬ事態に遭遇した際、どのように振る舞い、どのようにユーザーと開発者に情報を伝えるか」が設計されているものを指す。
エラーを恐れるな。エラーを、システムの信頼性を証明するための「ログ」として飼い慣らせ。それが、真のチーフアーキテクトへの道だ。
