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 & "を入力しました。")