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

定義

ダイアログ ボックスにプロンプトを表示して、ユーザーがテキストを入力するか、ボタンをクリックするのを待った後、テキスト ボックスの内容を含む文字列を返します。Displays a prompt in a dialog box, waits for the user to input text or click a button, and then returns a string containing the contents of the text box.

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 式です。Required String expression displayed as the message in the dialog box. Prompt の最大長は、約 1024 文字です。使用される文字の幅によって変わります。The maximum length of Prompt is approximately 1024 characters, depending on the width of the characters used. Prompt が複数の行で構成される場合、復帰文字 (Chr(13))、ライン フィード文字 (Chr(10))、または復帰文字とライン フィード文字の組み合わせ (Chr(13) & Chr(10)) を各行の間で使用して、行を分割できます。If Prompt consists of more than one line, you can separate the lines using a carriage return character (Chr(13)), a line feed character (Chr(10)), or a carriage return/line feed combination (Chr(13) & Chr(10)) between each line.

Title
String

任意。Optional. ダイアログ ボックスのタイトル バーに表示される String 型の式。String expression displayed in the title bar of the dialog box. Title を省略した場合、タイトル バーにはアプリケーションの名前が表示されます。If you omit Title, the application name is placed in the title bar.

DefaultResponse
String

任意。Optional. 他に入力がない場合に、テキスト ボックスに既定値として表示される String 型の式。String expression displayed in the text box as the default response if no other input is provided. DefaultResponse を省略すると、表示されるテキスト ボックスは空になります。If you omit DefaultResponse, the displayed text box is empty.

XPos
Int32

任意。Optional. ダイアログ ボックスの左端から画面の左端までの距離を twip 単位で指定する数式です。Numeric expression that specifies, in twips, the distance of the left edge of the dialog box from the left edge of the screen. XPos を省略すると、ダイアログ ボックスの水平位置が中央になります。If you omit XPos, the dialog box is centered horizontally.

YPos
Int32

任意。Optional. ダイアログ ボックスの上端から画面の上端までの距離を twip 単位で指定する数式です。Numeric expression that specifies, in twips, the distance of the upper edge of the dialog box from the top of the screen. YPos を省略すると、ダイアログ ボックスは垂直方向に対して画面の上端から約 1/3 の位置に配置されます。If you omit YPos, the dialog box is positioned vertically approximately one-third of the way down the screen.

戻り値

ダイアログ ボックスにプロンプトを表示して、ユーザーがテキストを入力するか、ボタンをクリックするのを待った後、テキスト ボックスの内容を含む文字列を返します。Displays a prompt in a dialog box, waits for the user to input text or click a button, and then returns a string containing the contents of the text box.

この例では、InputBox 関数を使用して、ユーザーに値の入力を求めるさまざまな方法を示します。This example shows various ways to use the InputBox function to prompt the user to enter a value. X と y の位置を省略した場合、ダイアログボックスは自動的に各軸の中央に配置されます。If the x and y positions are omitted, the dialog box is automatically centered for the respective axes. 変数 MyValue には、ユーザーが [OK] をクリックするか ENTER キーを押すと、ユーザーが入力した値が含まれます。The variable MyValue contains the value entered by the user if the user clicks OK or presses the ENTER key.

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の文字列が返されます。If the user clicks Cancel, a zero-length string is returned.

最初の引数よりも大きい値を指定するには、式で InputBox 関数を使用する必要があります。To specify more than the first argument, you must use the InputBox function in an expression. 位置指定引数を省略した場合は、対応するコンマ区切り記号を保持する必要があります。If you omit any positional arguments, you must retain the corresponding comma delimiter.

注意

@No__t-0 関数には @no__t 2 レベルの UIPermission が必要です。これは、部分信頼状況での実行に影響を与える可能性があります。The InputBox function requires UIPermission at the SafeTopLevelWindows level, which may affect its execution in partial-trust situations. 詳細については、「アクセス許可の要求」と UIPermission」を参照してください。For more information, see Requesting Permissions and UIPermission .

適用対象

こちらもご覧ください