【実務・中級編】【実務効率化】ページ数が増大したドキュメントで、特定キーワードのテキストを含むレイヤーやページを全自動検索してジャンプ – CorelDRAW VBA解析バイブル

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

【極限の設計】大規模ドキュメントを支配する「高速検索・自動ジャンプ」エンジニアリング

大規模なカタログや数百ページに及ぶテクニカルマニュアルの運用において、一箇所の修正指示が「どこに、どのレイヤーで、どのテキストとして存在するのか」を特定する作業は、エンジニアにとって最も忌避すべき「非生産的な時間」だ。

多くの開発者は、この問題を解決しようとして「全ページをループし、全レイヤーをループし、全シェイプをループする」という素朴なコードを書く。しかし、それはプロの仕事ではない。オブジェクト数万個、ページ数数百という極限状態において、そのアプローチはCorelDRAWのメモリを食いつぶし、アプリケーションをフリーズさせる「脆弱な設計」そのものだ。

本稿では、膨大なドキュメントを瞬時にスキャンし、ターゲットへ正確にジャンプさせる、プロダクションレベルのデバッグ支援ツールの設計思想と実装方法を伝授する。

1. 凡庸な設計と、アーキテクトの設計

なぜ、あなたの書いた検索ツールは重いのか? 理由は単純だ。「オブジェクトの探索空間(Search Space)」の制御を放棄しているからだ。

凡庸な設計(Naive Approach)

1. `For Each Page In Documents`
2. `For Each Layer In Page.Layers`
3. `For Each Shape In Layer.Shapes`
4. `If Shape.Text.Contents Like “*keyword*” Then…`

この「3重ループ」は、計算量が $O(n^3)$ に近い挙動を示し、さらに各ステップでプロパティ(`.Text.Contents`)にアクセスするたびに、VBAとCorelDRAWのコアエンジン間でのコンテキストスイッチが発生する。これが致命的な遅延を生む。

アーキテクトの設計(Architectural Approach)

1. `FindShapes` メソッドの活用: CorelDRAW内部で最適化された検索エンジンである `FindShapes` を使用し、C++レベルの高速なフィルタリングを行う。
2. 型判定の最小化: テキストシェイプ以外を探索対象から除外するフラグを事前に定義する。
3. 画面更新の完全制御: `Optimization` プロパティを駆使し、描画プロセスを完全に遮断する。
4. エラーハンドリングの局所化: 特定の破損したオブジェクトでプロセス全体が止まらないよう、例外処理を設計に組み込む。

2. プロダクションコード:高精度キーワード・ジャンプエンジン

以下に、実務に投入可能なレベルまで磨き上げたコードを示す。このコードは単なる「検索」ではなく、「特定したターゲットへの視覚的アクセス」に特化している。

Option Explicit

''' <summary>
''' 大規模ドキュメントにおけるテキスト検索・ジャンプ・ハイライト・エンジン
''' </summary>
Public Sub SearchAndJumpToKeyword()
    Dim doc As Document
    Set doc = ActiveDocument
    
    ' --- 1. 前提条件チェック ---
    If doc Is Nothing Then
        MsgBox "ドキュメントが開かれていません。", vbCritical
        Exit Sub
    End If

    Dim searchKeyword As String
    searchKeyword = InputBox("検索するキーワードを入力してください:", "高速検索エンジン")
    
    If searchKeyword = "" Then Exit Sub ' キャンセル時

    ' --- 2. パフォーマンス最適化の開始 ---
    ' 画面更新と描画プロセスを完全に停止させ、計算資源を検索に集中させる
    Optimization = True
    EventsEnabled = False
    
    Dim targetShape As Shape
    Dim foundCount As Long
    foundCount = 0
    
    On Error GoTo ErrorHandler

    ' --- 3. 高速検索フェーズ ---
    ' FindShapesを使用し、全ページ・全レイヤーから「テキストシェイプ」のみを
    ' CorelDRAWの内部エンジンで一括抽出する。これが最速の解だ。
    ' 検索範囲: 全ページ (All Pages)
    ' 検索条件: テキストシェイプのみ
    
    Dim allTextShapes As ShapeRange
    Set allTextShapes = doc.FindShapes(Type:=cdrTextShape)

    ' --- 4. フィルタリングとジャンプフェーズ ---
    ' 抽出されたテキストシェイプ集合に対してのみ、文字列照合を行う
    For Each targetShape In allTextShapes
        If InStr(1, targetShape.Text.Contents, searchKeyword, vbTextCompare) > 0 Then
            foundCount = foundCount + 1
            
            ' ターゲットを発見した際の挙動
            GoToFoundTarget targetShape, doc
            
            ' 連続して検索を続ける場合はここを調整するが、
            ' 実務デバッグでは「最初に見つかった場所」へのジャンプが最も効率的。
            Exit For 
        End If
    Next targetShape

    ' --- 5. 結果通知 ---
    If foundCount = 0 Then
        MsgBox "キーワード '" & searchKeyword & "' は見つかりませんでした。", vbInformation
    End If

CleanExit:
    ' --- 6. リソースの復元(極めて重要) ---
    ' OptimizationをTrueに戻さない限り、CorelDRAWは描画を停止したままになる。
    Optimization = False
    EventsEnabled = True
    Application.Refresh
    Exit Sub

ErrorHandler:
    MsgBox "実行中に予期せぬエラーが発生しました: " & Err.Description, vbCritical
    Resume CleanExit
End Sub

''' <summary>
''' ターゲットシェイプへの視覚的ジャンプとハイライトを実行する
''' </summary>
Private Sub GoToFoundTarget(ByRef sh As Shape, ByRef doc As Document)
    ' 1. ページをアクティブにする
    sh.Page.Activate
    
    ' 2. レイヤーを可視化する(非表示レイヤーにある場合への対策)
    sh.Layer.Visible = True
    
    ' 3. オブジェクトを選択状態にし、ハイライトする
    sh.Select
    
    ' 4. 画面をオブジェクトにフォーカスさせる(ズーム)
    ActiveWindow.ActiveView.ZoomToSelection
    
    ' 5. ユーザーへの通知
    MsgBox "ターゲットを発見: " & vbCrLf & _
           "ページ: " & sh.Page.Index & vbCrLf & _
           "レイヤー: " & sh.Layer.Name, vbInformation, "ジャンプ完了"
End Sub

3. 実装における「極限の知見」

このコードを単にコピーするだけでは、あなたはまだ「コードを書ける人」に過ぎない。この設計の裏にある、エンジニアリングの真髄を理解せよ。

なぜ `FindShapes` なのか?

`doc.FindShapes(Type:=cdrTextShape)` は、VBAのループによる探索ではなく、CorelDRAWのコア(C++層)に対して「テキストシェイプのリストを返せ」という命令を飛ばしている。これにより、VBAとアプリケーション間の通信回数が劇的に減少し、数万個のオブジェクトがあってもミリ秒単位での応答が可能になる。

`Optimization = True` の真の意味

これは単なる「画面のチラつき防止」ではない。CorelDRAWに対し、「今から大規模なメモリ操作を行うので、再描画(Redraw)の計算プロセスを完全にスキップせよ」という命令だ。これを忘れると、検索中にCorelDRAWは「シェイプが移動・選択されるたびに画面を書き換えよう」としてしまい、計算資源のほとんどを無駄な描画に費やすことになる。

レイヤーの可視性制御(Robustness)

実務のカタログでは、特定のレイヤーが「非表示(Hidden)」に設定されていることが多々ある。非表示レイヤー内のオブジェクトを `.Select` しようとしても、ユーザーの視覚には現れない。`sh.Layer.Visible = True` を組み込むことで、「見つかったのに見えない」という、デバッグツールとして致命的なUXの欠陥を防いでいる。

エラーハンドリングの設計

大規模ファイルには、必ずといっていいほど「壊れたオブジェクト(Corrupted Shape)」が含まれている。`On Error GoTo ErrorHandler` を適切に配置し、エラーが発生しても `Optimization = False` を確実に実行してアプリケーションを正常な状態に戻す。これこそが、「落ちないツール」と「落ちるツール」の境界線だ。

結論

業務自動化の真の価値は、単に作業を速めることではない。「不確実性を排除し、エンジニアの認知負荷を下げること」にある。

今回提示した設計は、大規模ドキュメントという「不確実な環境」において、最も効率的かつ堅牢に動作するように最適化されている。この設計思想を、あなたの次のプロジェクトにも適用してほしい。

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