VBAのMsgBoxで改行する方法

Excel作業でVBAのMsgBoxを使っていると、通知メッセージやエラー内容を伝えたいのに、長い文章を一行で表示してしまい読みにくくなった経験はないでしょうか。適切な位置でテキストを折り返す処理を行えば、ユーザーが内容を素早く理解できる見やすいメッセージボックスを作成できます。

この記事では、VBAのMsgBoxで改行する具体的な方法に加え、vbCrLfとvbNewLineの違いや変数を含む文字列の改行方法まで詳しく解説します。改行の仕組みを正しく理解したい方は、ぜひ参考にしてください。

メッセージウィンドウ内のテキストを分割する際は、専用の定数や関数を使い分けます。それぞれの記述方法によって、対応する実行環境やコードの可読性が変化する仕組みです。

読みやすいメッセージ表示について、デジタル庁のガイドラインは次のように述べています。

情報のまとまりを認識しやすくするため、適切な改行や余白を用いて、情報の構造を視認しやすく構成する。

出典:デジタル庁 デザインシステム ガイドライン

つまり、MsgBox内のテキストを適切に改行することは、単なる見た目の問題ではなく、情報を正しく伝えるための工夫といえます。

vbCrLfを使って改行する最小限のコードは、以下の通りです。

MsgBox "1行目です" & vbCrLf & "2行目です"

文字列と定数を「&」で連結するだけで、MsgBox内のテキストが2行に分かれて表示されます。以下の表は、この処理で使える3つの手法を比較したものです。

これらの手法はいずれもMsgBox内の改行に使えますが、対応する実行環境やコードの意図の伝わりやすさが異なります。次の項目では、それぞれの具体的な書き方を確認します。

vbCrLf定数を使う

メッセージの中で頻繁に利用されるのがvbCrLfという定数です。印字位置を先頭に戻す制御文字(キャリッジリターン)と次の行に送る制御文字(ラインフィード)を組み合わせたもので、Windowsにおける標準的な改行として機能します。

Dim msg As String
msg = "1行目です" & vbCrLf & "2行目です"
MsgBox msg

vbCrLf定数の主な特徴は、以下の通りです。

• 文字列の間に定数を挟んで結合する
• Windows版のExcel環境で広く普及している
• コードの意図が伝わりやすい

文字列と定数を & で繋ぐだけで、見た目を整える処理が完了します。視認性を高める工夫は、利用者のミスを防ぐ一助となる仕組みです。

定数名を記述するだけのシンプルな形式のため、VBAを学び始めたばかりの初心者でも扱いやすい手法といえます。

vbNewLine定数を使う

特定のOSに依存せず、実行中のシステムが定義する改行文字を挿入したい場合は、vbNewLineが適した選択です。仕様上はプラットフォーム固有の改行文字と定義されており、Windows環境ではvbCrLfと同じ結果を得られます。

MsgBox "1行目です" & vbNewLine & "2行目です"

vbNewLineを使った改行の手順は、以下の通りです。

1. 改行したい箇所に定数を配置する
2. 前後の文字列を演算子で連結する

MsgBoxでの表示結果はvbCrLfとほぼ変わりませんが、コードの意図を明示しつつ可読性を保ちたい場合に選ばれる傾向です。プロジェクト内で記述を統一する目的で採用するのが実務的な使い方といえます。

Chr関数で文字コードを指定する

定数を使わずに、Chr関数を用いて文字コードを直接指定する手順も有効です。柔軟な制御が必要な場面や特定の文字コードを優先したい特殊なケースで重宝します。

MsgBox "1行目です" & Chr(13) & Chr(10) & "2行目です"

Chr関数を使った改行の特徴は、以下の通りです。

• Chr(13) や Chr(10) を組み合わせて使用する
• 定数名が不明な環境でも数値を指定して実行できる

Chr(13) と Chr(10) の組み合わせは、定数を使用した場合、同じ結果を得られる方法です。場面に応じて使い分けることで、より精密なテキスト制御が実現します。

特定の制御文字を埋め込みたい場合や定数名を忘れてしまった場合に活用できる、上級者向けの選択肢といえます。

改行コードは、MsgBoxやセル内のテキストで「ここで行を変える」という命令をコンピューターに伝える文字です。前の章で紹介したvbCrLf・vbNewLine・Chr関数は、いずれもこの役割を果たしますが、選び方によってコードの意図の伝わりやすさが変わります。

用途別の選び方の目安は、以下の通りです。

この選び方はあくまで目安です。プロジェクト内で記述を統一しておくと、コードの可読性を保ちやすくなります。

Windows専用ツールではvbCrLfを選ぶ

Windows環境専用のツールを開発する場合は、認知度が高く動作が安定しているvbCrLfを選んでおけば安心です。定数名だけで意図が伝わるため、チームでコードを共有する際にも、読み手の負担を抑えられます。

他OSとの併用ではvbNewLineを選ぶ

Mac版Excelなど異なるOSとの併用を想定する場面では、実行環境ごとに適切な改行文字を判定するvbNewLineが選ばれる傾向です。ただし出力先のファイル形式まで統一するものではないため、外部ファイルへ書き出す場合は出力先の仕様に従う必要があります。

メッセージボックスに表示するテキストは、固定の文字列と変数を組み合わせて構成する場面が多く見られます。改行コードを変数や定数の間に挟むことで、実行時の状況に応じた読みやすい通知画面を構成できるのが特徴です。

連結演算子で定数と変数を結合する

定型の文章と動的に変わる変数を繋ぐ際は、連結演算子である「&」を使用します。vbCrLf を定数と変数の間に配置すると、指定した箇所で正確に改行を反映したメッセージを作成可能です。

Dim userName As String
userName = "田中"
MsgBox "こんにちは、" & userName & vbCrLf & "本日もよろしくお願いします。"

変数「userName」に代入した文字列がそのままメッセージへ差し込まれ、vbCrLfを挟んだ位置で改行されて2行に表示されます。以下の表は、この記述を構成する各要素の役割です。

連結の順序を工夫するだけで、挨拶文とユーザー名を分けるといったレイアウト調整が容易に行えます。複数の変数を並べる場合も、定数記号を間に挟む手法が一般的です。

複数の改行を連続して挿入する

1行の間隔では情報が密集して見える場合、改行用の定数を2回連続で記述する手法が有効です。1行分の空行を設けることで、見出しと本文を区別するような視覚的効果を得られます。

MsgBox "エラーが発生しました。" & vbCrLf & vbCrLf & "処理を中断します。"

vbCrLfを2回連続で記述すると、「エラーが発生しました」と「処理を中断します」の間に1行分の空行が挿入されます。両者は視覚的に区別され、読み手にとって分かりやすい表示です。

この記述のポイントは、以下の通りです。

• 定数同士を「&」で連結して2連続にする
• 視認性を高めるために上下に余白を作る
• エラー内容と対処法を物理的に分離する

情報の優先度が高い内容を表示する際は、意図的に余白を増やす設計が推奨されます。定数を繰り返す記述は、コードの可読性を保ちつつ画面構成を整える手段として頻繁に活用される工夫です。

MsgBoxで改行できない原因は何ですか？

多くの場合、文字列と改行定数を繋ぐ「&」記号の記述漏れやvbCrLfなどの定数名のスペルミスが原因です。まずは「&」による連結と、文字列を囲むダブルクォーテーションの範囲を確認しましょう。

改行コードを文字列として表示させることはできますか？

改行定数を実行させず、テキストとしてそのまま見せるにはダブルクォーテーションで囲む方法が有効です。たとえば"vbCrLf"のように定数名ごと引用符で囲むと、コードの解説をメッセージ内でそのまま表示できます。

ITやプログラミングに関するコラム

• 
  【Python】FastAPIで料金プラン見積もりシミュレーターを作ってみた
• 
  【Python】pandasとmatplotlibで在庫データのABC分析と構成比を可視化してみた
• 
  【Python】Flaskで社内FAQをカテゴリ検索できるWebアプリを作ってみた
• 
  【Python】argparseでJSON整形・構文検証・キー検索CLIを試してみた
• 
  【Python】NumPyとmatplotlibでモンテカルロ法による円周率推定と収束過程の可視化を試してみた
• 
  【Python】Playwrightでスクレイピングを試してみた
• 
  【CSS】notで複数の件を除外する方法
• 
  【Git】remote設定を変更する方法
• 
  【VBA】コメントアウトを設定する方法
• 
  x86とx64の違いを分かりやすく解説

ITやプログラミングに関するニュース

• 
  VercelがAI GatewayにSeedream 5.0 Proを追加、AI SDKのモデル指定で画像生成と編集が可能に
• 
  AWSがAmazon LocationのPlaces APIを強化、住所表記の指定と移動手段別の検索が可能に
• 
  VercelがトレースにTree・Waterfallビューを追加、ログ画面で処理の階層と所要時間を確認可能に
• 
  Googleがエージェント評価の再考を提唱、難易度を情報量で測るDiscovery Benchを解説
• 
  Google CloudがCloud Runサンドボックスを公開プレビューで提供、サービスヘルスは一般提供に
• 
  Google Cloud EMEAが英国金融の重要第三者に指定、イングランド銀行・PRA・FCAの直接監督下に
• 
  AWS DMS Schema ConversionがSQL Serverのオフライン変換に対応、ソースDBへ接続せずスキーマを変換可能に
• 
  EC2 G7インスタンスが米国東部（バージニア北部）で利用可能に、G6比でAI推論性能が最大4.6倍
• 
  SageMaker HyperPodが継続プロビジョニングでのAMIベース構成に対応、S3のスクリプト管理なしでSlurmクラスターを作成可能に
• 
  AWSがEMR on EKSでSparkトラブルシューティングエージェントに対応、失敗ジョブの原因分析を自然言語で依頼可能に