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

定義

名前空間:
Microsoft.VisualBasic
アセンブリ:
Microsoft.VisualBasic.dll

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

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複数の行で構成されている場合は、改行文字 (Chr(13))、改行文字 (Chr(10))、または改行/改行の組み合わせ (Chr(13) & Chr(10)) を使用して行を区切ることができます。

Title
String

オプション。 String 式がダイアログ ボックスのタイトル バーに表示されます。 Title省略すると、アプリケーション名がタイトル バーに配置されます。

DefaultResponse
String

オプション。 String 他の入力が指定されていない場合は、既定の応答としてテキスト ボックスに表示される式。 DefaultResponseを省略すると、表示されるテキスト ボックスは空になります。

XPos
Int32

オプション。 画面の左端からダイアログ ボックスの左端までの距離を twip 単位で指定する数値式。 XPosを省略すると、ダイアログ ボックスは水平方向に中央揃えになります。

YPos
Int32

オプション。 画面の上端からダイアログ ボックスの上端までの距離を twip 単位で指定する数値式。 YPos省略すると、ダイアログ ボックスは画面の約 3 分の 1 の垂直方向に配置されます。

返品

String

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

例

この例では、 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 関数を使用する必要があります。 位置指定引数を省略する場合は、対応するコンマ区切り記号を保持する必要があります。

Note

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

適用対象

こちらもご覧ください