Interaction.InputBox(String, String, String, Int32, Int32) メソッド

定義

ダイアログ ボックスにプロンプトを表示して、ユーザーがテキストを入力するか、ボタンをクリックするのを待った後、テキスト ボックスの内容を含む文字列を返します。

public static string InputBox (string Prompt, string Title = "", string DefaultResponse = "", int XPos = -1, int YPos = -1);
static member InputBox : string * string * string * int * int -> string
Public Function InputBox (Prompt As String, Optional Title As String = "", Optional DefaultResponse As String = "", Optional XPos As Integer = -1, Optional YPos As Integer = -1) As String

パラメーター

Prompt
String

必須。ダイアログ ボックスにメッセージとして表示する String 式です。 Prompt の最大長は、約 1024 文字です。使用される文字の幅によって変わります。 複数の行で構成されている場合Promptは、復帰文字 (13))、改行Chr(文字 (Chr(10))、または復帰/改行の組み合わせ (Chr(13) & Chr(10)) を使用して各行を区切ることができます。

Title
String

省略可能。 ダイアログ ボックスのタイトル バーに表示される String 型の式。 Title を省略した場合、タイトル バーにはアプリケーションの名前が表示されます。

DefaultResponse
String

省略可能。 他に入力がない場合に、テキスト ボックスに既定値として表示される String 型の式。 DefaultResponse を省略すると、表示されるテキスト ボックスは空になります。

XPos
Int32

省略可能。 ダイアログ ボックスの左端から画面の左端までの距離を twip 単位で指定する数式です。 XPos を省略すると、ダイアログ ボックスの水平位置が中央になります。

YPos
Int32

省略可能。 ダイアログ ボックスの上端から画面の上端までの距離を twip 単位で指定する数式です。 YPos を省略すると、ダイアログ ボックスは垂直方向に対して画面の上端から約 1/3 の位置に配置されます。

戻り値

ダイアログ ボックスにプロンプトを表示して、ユーザーがテキストを入力するか、ボタンをクリックするのを待った後、テキスト ボックスの内容を含む文字列を返します。

この例では、 関数を使用してユーザーに値の InputBox 入力を求めるさまざまな方法を示します。 x と y の位置を省略すると、ダイアログ ボックスはそれぞれの軸の中央に自動的に配置されます。 変数 MyValue には、ユーザーが [OK] をクリックするか Enter キーを押した場合にユーザーが入力した値が含まれます。

Dim message, title, defaultValue As String
Dim myValue As Object
' Set prompt.
message = "Enter a value between 1 and 3"
' Set title.
title = "InputBox Demo"
defaultValue = "1"   ' Set default value.

' Display message, title, and default value.
myValue = InputBox(message, title, defaultValue)
' If user has clicked Cancel, set myValue to defaultValue
If myValue Is "" Then myValue = defaultValue

' Display dialog box at position 100, 100.
myValue = InputBox(message, title, defaultValue, 100, 100)
' If user has clicked Cancel, set myValue to defaultValue
If myValue Is "" Then myValue = defaultValue

注釈

ユーザーが [キャンセル] をクリックすると、長さ 0 の文字列が返されます。

最初の引数より多くを指定するには、式で 関数を InputBox 使用する必要があります。 位置指定引数を省略する場合は、対応するコンマ区切り記号を保持する必要があります。

注意

関数には InputBox レベルがSafeTopLevelWindows必要UIPermissionです。これは、部分信頼の状況での実行に影響を与える可能性があります。 詳細については、「 アクセス許可の要求 」および UIPermission 「」を参照してください。

適用対象

こちらもご覧ください