削除処理を実行するマクロを他の人に渡したら、間違って押されてデータが消えた。処理する月を毎回コードの中の数字で書き換えている。
こうした場面で使うのが MsgBox と InputBox です。確認をはさむ、値を入力してもらう、という2つの動作でマクロの実用性が変わります。この記事では、それぞれの書き方と使い分けを解説します。
MsgBoxの基本
Sub MsgBoxBasic() MsgBox "処理が完了しました" End Sub
引数は3つ覚えれば十分です。
MsgBox prompt, buttons, title
| 引数 | 内容 |
|---|---|
| prompt | 表示する文字列(必須) |
| buttons | ボタンの種類とアイコンの指定 |
| title | ダイアログのタイトル(省略すると「Microsoft Excel」) |
Sub MsgBoxWithTitle() MsgBox "3件のデータを登録しました", vbInformation, "登録完了" End Sub
タイトルを付けると、どのマクロからのメッセージか分かるようになります。複数のマクロを配布している場合は指定しておくと問い合わせが減ります。
ボタンとアイコンの定数
buttons には、ボタンの種類とアイコンを + でつなげて指定します。
| ボタンの定数 | 表示されるボタン |
|---|---|
| vbOKOnly(既定) | OK |
| vbOKCancel | OK / キャンセル |
| vbYesNo | はい / いいえ |
| vbYesNoCancel | はい / いいえ / キャンセル |
| vbRetryCancel | 再試行 / キャンセル |
| vbAbortRetryIgnore | 中止 / 再試行 / 無視 |
| アイコンの定数 | 用途 |
|---|---|
| vbInformation | 完了通知などの情報 |
| vbExclamation | 注意・警告 |
| vbCritical | エラー・重大な警告 |
| vbQuestion | 確認の問いかけ |
MsgBox "データを削除します。よろしいですか?", vbYesNo + vbQuestion, "確認"
既定で選択されるボタンを変えたい場合は vbDefaultButton2 を加えます。誤操作を防ぎたい確認では、「いいえ」を既定にしておくのが安全です。
MsgBox "全データを削除します", vbYesNo + vbExclamation + vbDefaultButton2, "確認"
押されたボタンで処理を分ける
戻り値を受け取るときは、引数をかっこで囲みます。
Sub ConfirmDelete() Dim ret As VbMsgBoxResult ret = MsgBox("選択中のデータを削除します。よろしいですか?", _ vbYesNo + vbQuestion + vbDefaultButton2, "削除の確認") If ret = vbYes Then Selection.ClearContents MsgBox "削除しました", vbInformation Else MsgBox "中止しました", vbInformation End If End Sub
かっこの有無を間違えるとコンパイルエラーになります。戻り値を使うときは MsgBox(...)、使わないときは MsgBox ... と覚えます。
条件を短く書くなら、1行にまとめられます。
If MsgBox("実行しますか?", vbYesNo) = vbNo Then Exit Sub
処理の先頭にこの1行を入れておくだけで、誤実行の事故は大きく減ります。
3択の場合は Select Case で分けます。
Select Case MsgBox("変更を保存しますか?", vbYesNoCancel + vbQuestion) Case vbYes ThisWorkbook.Save Case vbNo ' 保存せず続行 Case vbCancel Exit Sub End Select
改行を入れて読みやすくする
長いメッセージは改行して整えます。改行には vbCrLf または vbNewLine を使います。
Sub MsgBoxMultiLine() Dim msg As String msg = "以下の内容で処理します。" & vbCrLf & vbCrLf msg = msg & "対象シート : " & ActiveSheet.Name & vbCrLf msg = msg & "対象件数 : " & Cells(Rows.Count, 1).End(xlUp).Row - 1 & " 件" & vbCrLf & vbCrLf msg = msg & "続行しますか?" If MsgBox(msg, vbYesNo + vbQuestion, "実行前の確認") = vbNo Then Exit Sub End Sub
処理対象をこの形で提示すると、実行前に間違いに気づけます。なお MsgBox で表示できる文字数は約1024文字までです。一覧を全部表示するような使い方には向かないため、件数が多い場合は別シートに書き出します。
InputBoxで値を入力してもらう
VBAの InputBox 関数は、入力された内容を常に文字列で返します。
Sub InputBoxBasic() Dim ans As String ans = InputBox("処理する月を入力してください(1〜12)", "月の指定", Month(Date)) If ans = "" Then Exit Sub ' キャンセルまたは空欄 If Not IsNumeric(ans) Then MsgBox "数値を入力してください", vbExclamation Exit Sub End If MsgBox CInt(ans) & "月のデータを処理します" End Sub
第3引数に既定値を入れておくと、そのまま使えるので入力の手間が減ります。
注意点は、キャンセルと空欄のどちらも空文字が返ることです。厳密に区別したい場合は StrPtr を使いますが、実務では「空ならやめる」で十分なケースが多いため、上のように空文字で判定するのが簡潔です。
Application.InputBoxで型を指定する
Application.InputBox はExcel側の機能で、入力の型を指定できます。数値以外を入力すると、Excel自身が警告を出して再入力を求めるため、自分でチェックを書く必要が減ります。
Sub AppInputNumber() Dim n As Variant n = Application.InputBox("処理件数を入力してください", "件数", 10, Type:=1) If n = False Then Exit Sub ' キャンセルされた MsgBox n & " 件を処理します" End Sub
| Type | 受け付ける値 |
|---|---|
| 0 | 数式 |
| 1 | 数値 |
| 2 | 文字列 |
| 4 | 論理値(True / False) |
| 8 | セル参照(Rangeオブジェクト) |
| 16 | エラー値 |
特に便利なのが Type:=8 です。ダイアログを出したままセルをドラッグ選択させ、その範囲を受け取れます。
Sub SelectRangeByUser() Dim rng As Range On Error Resume Next Set rng = Application.InputBox("集計する範囲を選択してください", "範囲の指定", Type:=8) On Error GoTo 0 If rng Is Nothing Then Exit Sub ' キャンセルされた MsgBox rng.Address & " の合計は " & _ WorksheetFunction.Sum(rng) & " です", vbInformation End Sub
Type:=8 でキャンセルされるとエラーが発生するため、On Error Resume Next と Is Nothing の組み合わせで受け止めます。
正しい値が入るまで聞き直す
入力チェックを繰り返す場合は Do Loop を使います。
Sub InputUntilValid() Dim ans As String Dim m As Long Do ans = InputBox("処理する月を入力してください(1〜12)", "月の指定") If ans = "" Then Exit Sub ' キャンセルで抜ける If IsNumeric(ans) Then m = CLng(ans) If m >= 1 And m <= 12 Then Exit Do ' 正しい入力なのでループを抜ける End If MsgBox "1〜12の数値を入力してください", vbExclamation Loop MsgBox m & "月分の処理を開始します" End Sub
Exit Sub を先に書いておくことで、キャンセル時に無限ループにならないようにしています。
使いどころを見極める
便利な反面、使いすぎると逆に手間が増えます。
- ループの中に入れない:100件処理するマクロでMsgBoxを100回出すと、誰も使いません。処理件数や失敗した件数をためておき、最後に1回だけ表示します
- 定期実行するマクロには入れない:トリガーや
Workbook_Openで自動実行する処理にダイアログを入れると、誰かがクリックするまで処理が止まります - 入力項目が3つ以上ならUserFormを検討する:
InputBoxを連続で出すのは操作として煩わしくなります - Excel自身の警告とは別物:「シートを削除しますか」のようなExcelの確認は
Application.DisplayAlerts = Falseで抑制します。MsgBoxとは仕組みが違います
エラー時の通知も、件数をまとめて1回で出す形にします。
Sub ReportAtEnd() Dim i As Long, ngCount As Long Dim ngList As String For i = 2 To 100 If Not IsNumeric(Cells(i, 3).Value) Then ngCount = ngCount + 1 If ngCount <= 10 Then ngList = ngList & vbCrLf & " ・" & i & "行目" End If Next i If ngCount = 0 Then MsgBox "エラーはありませんでした", vbInformation Else MsgBox "数値以外のデータが " & ngCount & " 件あります" & ngList & _ IIf(ngCount > 10, vbCrLf & " ・(他 " & ngCount - 10 & " 件)", ""), _ vbExclamation, "チェック結果" End If End Sub
まとめ
MsgBoxの引数は prompt・buttons・title の3つ- 戻り値を使うときはかっこで囲む。
= vbYesで判定する - 削除などの危険な処理は
vbDefaultButton2で「いいえ」を既定にする - 改行は
vbCrLf。表示は約1024文字まで InputBoxの戻り値は文字列。キャンセルも空欄も空文字が返るApplication.InputBoxはTypeで型を指定でき、Type:=8でセル範囲を受け取れる- ループ内や自動実行マクロにダイアログを置かない
処理の先頭に確認を1行入れるだけで、「押し間違いで消えた」という事故は防げます。他の人に渡すマクロほど、この1行が効いてきます。
他の記事でもExcel VBAの実務的なテクニックを紹介していますので、ぜひチェックしてみてください。