InputBox 関数

InputBox(prompt [, title, default, xpos, ypos, helpfile, context])

ダイアログ ボックスにメッセージとテキスト ボックスを表示し、テキストが入力されるか、またはボタンがクリックされると、テキスト ボックスの内容を返します。

引数

prompt
ダイアログ ボックス内にメッセージとして表示する文字列を示す文字列式を指定します。引数 prompt に指定できる最大文字数は、1 バイト文字で約 1,024 文字です。ただし、使う文字の文字幅に依存します。引数 prompt に複数行を指定するには、改行する場所にキャリッジ リターン (Chr(13))、ライン フィード (Chr(10))、またはキャリッジ リターンとライン フィードの組み合わせ (Chr(13) & Chr(10)) を挿入してください。
title
省略可能です。
ダイアログ ボックスのタイトル バーに表示する文字列を示す文字列式を指定します。引数 title を省略すると、タイトル バーにはアプリケーション名が表示されます。
default
省略可能です。
ユーザーが何も入力しない場合に、テキスト ボックスに既定値として表示する文字列式を指定します。引数 default を省略すると、テキスト ボックスには何も表示されません。
xpos
省略可能です。
画面の左端からダイアログ ボックスの左端までの水平方向の距離を twip 単位で示す数式を指定します。引数 xpos を省略すると、ダイアログ ボックスは水平方向に対して画面の中央の位置に配置されます。
ypos
省略可能です。
画面の上端からダイアログ ボックスの上端までの垂直方向の距離を twip 単位で示す数式を指定します。引数 ypos を省略すると、ダイアログ ボックスは垂直方向に対して画面の上端から約 1/3 の位置に配置されます。
helpfile
省略可能です。
ダイアログ ボックスに状況依存のヘルプを設定するために、使用するヘルプ ファイルの名前を示す文字列式を指定します。この引数は、表示するダイアログ ボックスの説明を、ヘルプを使って表示するときに指定します。引数 helpfile を指定した場合は、引数 context も指定する必要があります。
context
省略可能です。
ヘルプ トピックに指定したコンテキスト番号を表す数式を指定します。引数 context を指定した場合は、引数 helpfile も指定する必要があります

解説

引数 helpfile および引数 context を指定すると、ダイアログ ボックスに自動的に [ヘルプ] ボタンが追加されます。

[OK] をクリックするか、または Enter キーを押すと、InputBox 関数はテキスト ボックスの内容を返します。[キャンセル] をクリックすると、InputBox 関数は長さ 0 の文字列 ("") を返します。

使用例

次のコードは、InputBox 関数を使って入力ボックスを表示し、文字列を変数の入力に関連付ける例です。

Dim Input
Input = InputBox("名前を入力してください。")
MsgBox (Input & "を入力しました。")
              

関連

MsgBox 関数

このページの先頭へ