Word VBAのUndo（元に戻す）スタックを掌握せよ：業務自動化ツールを「市民権」のあるアプリにする技術
Word VBAでドキュメントを操作する際、多くのエンジニアが陥る罠がある。それは「VBAによる変更がUndoスタックを細切れにし、ユーザーの体験を破壊する」という問題だ。
ループの中で一つ一つプロパティを書き換えるコードを書けば、ユーザーは「Ctrl+Z」を100回連打しなければ元の状態に戻れなくなる。これは業務自動化ツールとしては失格だ。プロフェッショナルは、自分の書いたコードがユーザーの操作履歴とどう協調するかを設計する。
今回は、Undoスタックを統合し、VBAの変更を「一塊の操作」としてWordに認識させるためのアーキテクチャを伝授する。
—
1. なぜ「Undoスタックの断片化」が罪深いのか
VBAで `Selection` や `Range.Font` を繰り返し操作すると、Wordの内部エンジンは各操作を個別のイベントとしてスタックに積み上げる。ユーザーから見れば、「一瞬で終わったはずのツールなのに、元に戻すボタンを押すと一つずつしか戻らない」という悪夢のような挙動になる。
これは単なるUXの低下ではない。ドキュメントの整合性や、ユーザーの誤操作に対する「安心感」を奪う行為だ。堅牢な業務ツールは、実行結果を「一つのトランザクション」として扱う必要がある。
—
2. Undoスタックを統合する「Application.UndoRecord」の極意
Word 2010から導入された `UndoRecord` オブジェクトを使いこなせているだろうか。これこそが、VBAによる複数操作を一つの Undo ユニットにまとめるための唯一にして最強の武器だ。
以下の設計パターンをテンプレートとして活用してほしい。
実装コード：Undoスタック統合パターン
‘ — 堅牢な書式設定のためのラッパー —
Public Sub ApplyProfessionalFormatting()
Dim app As Application: Set app = Application
Dim undo As UndoRecord
Set undo = app.UndoRecord
‘ ユーザーの操作履歴に「一塊の履歴」として記録を開始
undo.StartCustomRecord “一括書式設定の適用”
On Error GoTo Cleanup
‘ ここに重い処理を記述する
Call ProcessDocumentFormatting(ActiveDocument)
Cleanup:
‘ 処理の成否に関わらず必ず記録を終了させる
undo.EndCustomRecord
If Err.Number <> 0 Then
MsgBox “エラーが発生しました: ” & Err.Description, vbCritical
End If
End Sub
Private Sub ProcessDocumentFormatting(doc As Document)
‘ 画面描画を停止してパフォーマンスを極限まで引き上げる
Application.ScreenUpdating = False
Dim para As Paragraph
For Each para In doc.Paragraphs
With para.Range
‘ 効率的な書式適用：オブジェクトに直接アクセスせず、一度に書き込む
.Font.Name = “游明朝”
.Font.Size = 10.5
.ParagraphFormat.LineSpacingRule = wdLineSpaceSingle
End With
Next para
Application.ScreenUpdating = True
End Sub
—
3. 現場で生き残るための「3つの絶対鉄則」
コードを動かすだけなら初学者でもできる。だが、本番環境で「バグのないツール」であり続けるためには、以下の原則を守れ。
① 画面描画の抑制は「義務」である
`Application.ScreenUpdating = False` は単なる高速化ではない。Undo記録中、画面のチラつきを抑え、Wordの内部リソース負荷を下げるために必須だ。ただし、エラーで終了した際に `True` に戻し忘れると、ユーザーのWordが「固まった」ように見える。必ず `On Error` 構文と組み合わせること。
② Undo記録の「スコープ」を意識せよ
`StartCustomRecord` はネストできない。大きな処理の中で小さな処理を呼び出す場合、UndoRecordの管理を上位レイヤーで行うか、呼び出し側の状態をチェックする設計が必要になる。
③ データベース連携時のトランザクション管理
もしこのVBAが外部DBからデータを読み込み、ドキュメントを生成するツールであれば、「ドキュメントのUndo」と「DBのトランザクション」は別物であることを忘れてはならない。
- DBの更新が失敗しても、Word上の変更は残る。
- ドキュメント生成が途中で止まった場合、Undoを呼び出して変更をロールバックする「リカバリルーチン」を実装するのが、上級者の作法だ。
—
結論：あなたのコードは「ユーザーの味方」か
VBAを書くことは、Wordという巨大なアプリケーションの「振る舞い」を拡張することだ。単に動くコードを書き捨てるのではなく、ユーザーが「元に戻す」を押した時にどう感じるかまでをデザインする。
この視点を持つだけで、あなたの自動化ツールは「個人の趣味レベル」から「組織の標準ツール」へと進化する。
さあ、Undoスタックを制御し、Wordという巨大なキャンバスを意のままに操るアーキテクトになれ。
