Interaction.InputBox(String, String, String, Int32, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ダイアログ ボックスにプロンプトを表示して、ユーザーがテキストを入力するか、ボタンをクリックするのを待った後、テキスト ボックスの内容を含む文字列を返します。
public static string InputBox (string Prompt, string Title = "", string DefaultResponse = "", int XPos = -1, int YPos = -1);static member InputBox : string * string * string * int * int -> stringPublic 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 「」を参照してください。
適用対象
こちらもご覧ください
.NET