Microsoft Access Club >VBA物語 >このページ  サイト内検索


InputBox 関数:VBA物語Help



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

基本構文

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

InputBox 関数の構文は、次の名前付き引数から構成されます。

指定項目 内容
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 も指定する必要があります。

解説

  1. 名前付き引数 helpfile と context の両方を指定すると、ユーザ-は F1 キーを押してコンテキスト番号に対応するヘルプトピックを参照できます。
  2. たとえば Microsoft Excelなどのホスト アプリケーションでは、自動的にダイアログボックスに OK ボタンが追加されます。
  3. OKボタンをクリックするか、または Enter キーを押すと、InputBox関数はテキスト ボックスの内容を返します。
  4. キャンセル ボタンをクリックすると、InputBox 関数は長さ 0の文字列 ("") を返します。

留意点

  1. 名前付き引数 prompt 以外の引数も指定する場合は、式の中で InputBox 関数を使う必要があります。
    この場合、引数を省略するには、それに対応する位置にカンマ区切り記号を記述します。

ページの先頭へ 前ページへ戻る

 


InputBox 関数:VBA物語Help


 

-Microsoft Access Club-