Word VBAを掌握せよ：Range.FormattedTextで実現する「秒速」書式適用術
Word VBAを書いている多くのエンジニアが陥る罠がある。それは、「プロパティを一つずつ叩く」という非効率なルーチンだ。
`Selection.Font.Name = “Meiryo”`
`Selection.Font.Size = 10.5`
`Selection.ParagraphFormat.LineSpacingRule = wdLineSpaceSingle`
数行なら問題ない。しかし、数千ページのドキュメントや、動的に生成される帳票でこれを繰り返せば、Wordはレンダリングのオーバーヘッドで悲鳴を上げ、実行時間は目に見えて遅延する。プロフェッショナルは、「オブジェクトの操作回数を最小化する」ことこそがパフォーマンスの要諦であることを知っている。
本稿では、Word VBAの深淵にある「書式の一括コピー」という極意を伝授する。
—
1. なぜプロパティ操作は「悪」なのか
Wordのオブジェクトモデルにおいて、`Selection`や`Range`の個別のプロパティ（Font, ParagraphFormatなど）にアクセスするたび、COMインターフェースを介した重い通信が発生する。
特に、UIを伴う`Selection`オブジェクトを動かすことは、Wordの画面描画処理を伴うため、パフォーマンスを殺す最大の要因となる。我々が目指すべきは、「裏側（Range）で完結させ、描画を一度に済ませる」ことだ。
2. 究極の解：FormattedTextプロパティによる書式転写
`FormattedText`プロパティは、Range内のテキストとその書式を、そのまま別のRangeへ「流し込む」ための強力な武器だ。個別のプロパティを一つ一つ設定する必要はない。理想的な書式を持つ「マスター領域」を定義し、それを対象範囲にコピーすればいい。
実践：高速書式適用エンジンのコード例
以下のコードは、特定のスタイルを動的に適用するためのプロダクションレベルの実装だ。
”’
”’
”’ 書式を適用したいターゲット範囲
”’ マスターとなる書式を持つ範囲
Public Sub ApplyFormatFast(ByRef targetRange As Range, ByRef sourceRange As Range)
‘ エラーハンドリング：Rangeの正当性を確認
If targetRange Is Nothing Or sourceRange Is Nothing Then Exit Sub
‘ ScreenUpdatingをオフにすることで、描画更新による遅延を遮断
Application.ScreenUpdating = False
‘ FormattedTextプロパティで書式を直接転写
‘ これにより、個別のプロパティ設定によるCOM呼び出しを1回に集約する
targetRange.FormattedText = sourceRange.FormattedText
Application.ScreenUpdating = True
End Sub
3. なぜこの設計が「堅牢」なのか
この設計には、単なる速度以上のメリットがある。
1. カプセル化の徹底: 書式設定のロジックが`sourceRange`という「テンプレート」に依存しているため、将来的なデザイン変更があっても、コードを書き換える必要はない。Wordドキュメント上の「ダミーテキスト」を修正するだけでツールが追従できる。
2. 描画負荷の回避: `Application.ScreenUpdating = False`を挟むことで、Wordがバックグラウンドで高速に処理を終える。
3. 保守性: プロパティが散らばったスパゲッティコードではなく、「何を（target）」「何を基準に（source）」という操作が明確になる。
4. プロの現場での注意点：オブジェクトのライフサイクル
この手法を使う際、一点だけ注意してほしい。`FormattedText`によるコピーは、ターゲットの全書式を上書きする。一部の書式（例えば太字だけ残したいなど）には向かない。
- データベース連携時のコツ:
外部のCSVやDBからデータを流し込む際は、まずプレーンテキストを挿入し、その後にスタイルを適用する。この際、`Range.Collapse`メソッドを使って範囲を適切に制御しないと、予期せぬ書式の伝播（段落記号が巻き込まれる等）が発生する。
- 堅牢なコードへの道:
常に `Set targetRange = …` と変数に格納し、その変数を操作すること。`Selection`は絶対に使わない。`Selection`は「ユーザーの操作」であり、コードの実行主体ではない。
終わりに：アーキテクトとしての提言
「書式設定」という些細な機能にこそ、エンジニアの質が出る。
一つ一つのプロパティをいじくり回すのは、初心者のやり方だ。オブジェクトの背後にあるデータ構造を理解し、一括でメモリを流し込む——これこそが、大規模なドキュメント処理における「伝説のエンジニア」の流儀である。
君のコードが、単に動くだけのものではなく、エレガントで高速な「システム」であることを期待している。さあ、今すぐ不要なプロパティ操作を削除し、この設計に書き換えたまえ。
