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