導入
Excel VBAでマクロを作成していると、「処理の途中でユーザーから値を受け取りたい」という場面が必ず訪れます。例えば、シートの名前を指定したり、検索キーワードを入力させたりする場合です。このような時に活躍するのがInputBox関数です。
入力を促すダイアログボックスを簡単に表示できるため、ユーザーインターフェースを向上させ、プログラムの柔軟性を高めるための必須テクニックです。
基礎知識
InputBox関数は、ユーザーからの入力を「文字列」として取得するための関数です。
基本的な構文は以下の通りです。
InputBox(Prompt, Title, Default, Xpos, Ypos, HelpFile, Context)
特に重要な引数は以下の3つです。
・Prompt:ダイアログに表示するメッセージ(必須)
・Title:ダイアログのタイトルバーに表示する文字列
・Default:テキストボックスに最初から表示しておく値
引数を指定することで、ダイアログの表示位置を調整することも可能です。
実装/解決策
実務でInputBoxを使う際、最も注意すべきなのは「ユーザーによるキャンセル」と「空欄のままOK」の区別です。
単に空文字(””)を判定するだけでは、キャンセルされたのか、意図的に空欄にしたのかが分かりません。これを正確に判別するには、StrPtr関数を組み合わせて使用します。
サンプルプログラム
以下のコードは、6文字以内の入力を求め、キャンセル時と未入力時を明確に区別して処理する実用的な例です。
Sub InputBoxSample()
Dim myStr As String
‘ ループを使って正しい入力があるまで繰り返す
Do While True
myStr = InputBox(“6文字以内で文字列を入力してください”, “データ入力”)
‘ (1) キャンセルボタン、または[×]で閉じた場合の判定
‘ StrPtr関数でメモリ上のアドレスを確認し、0ならキャンセルと判断
If StrPtr(myStr) = 0 Then
MsgBox “処理をキャンセルしました”
Exit Do
‘ (2) 何も入力せずに[OK]を押した場合
ElseIf myStr = “” Then
MsgBox “未入力です。何か入力してください。”, vbExclamation
‘ (3) 文字数制限のチェック
ElseIf Len(myStr) > 6 Then
MsgBox “6文字以内で入力してください!”, vbExclamation
‘ (4) 正常に入力された場合
Else
MsgBox “「” & myStr & “」を受け付けました”
Exit Do
End If
Loop
End Sub
応用・注意点
・InputBoxメソッドとの違い:InputBox関数は「文字列」を取得するのに特化しています。もし「セル範囲」や「数値」のみを正確に取得したい場合は、ApplicationオブジェクトのInputBoxメソッドを使用してください。メソッド版は型指定が可能なため、より厳密な制御が可能です。
・StrPtr関数の活用:StrPtr関数は非表示メンバのため、コード補完(インテリセンス)には表示されませんが、正しく動作します。この関数を使うことで、キャンセル操作を確実に検知できるため、ユーザーの意図しない操作によるエラーを未然に防ぐことができます。
現場では、ユーザーが「間違えてOKを押した」「キャンセルしたかった」という状況は頻発します。InputBoxを使う際は、必ずキャンセル時の処理を実装するように心がけましょう。
