インハムシステムの自動化ノート

現役エンジニアが、Excel VBA・Google Apps Scriptによる業務効率化のヒントをお届けします。

【Excel VBA】MsgBoxとInputBoxで確認・入力を受け取る方法

削除処理を実行するマクロを他の人に渡したら、間違って押されてデータが消えた。処理する月を毎回コードの中の数字で書き換えている。

こうした場面で使うのが 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の実務的なテクニックを紹介していますので、ぜひチェックしてみてください。