Interaction.InputBox メソッド

.NET Framework クラス ライブラリ リファレンス

Interaction.InputBox メソッド

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

名前空間: Microsoft.VisualBasic
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Shared Function InputBox
 ( _
    Prompt As String, _
    <OptionalAttribute> Optional Title As
 String = "", _
    <OptionalAttribute> Optional DefaultResponse As
 String = "", _
    <OptionalAttribute> Optional XPos As
 Integer = -1, _
    <OptionalAttribute> Optional YPos As
 Integer = -1 _
) As String

Visual Basic (使用法)

Dim Prompt As String
Dim Title As String
Dim DefaultResponse As String
Dim XPos As Integer
Dim YPos As Integer
Dim returnValue As String

returnValue = Interaction.InputBox(Prompt, Title, DefaultResponse, XPos, YPos)

C#

public static string InputBox
 (
    string Prompt,
    [OptionalAttribute] string Title,
    [OptionalAttribute] string DefaultResponse,
    [OptionalAttribute] int XPos,
    [OptionalAttribute] int YPos
)

C++

public:
static String^ InputBox (
    String^ Prompt, 
    [OptionalAttribute] String^ Title, 
    [OptionalAttribute] String^ DefaultResponse, 
    [OptionalAttribute] int XPos, 
    [OptionalAttribute] int YPos
)

J#

public static String InputBox (
    String Prompt, 
    /** @attribute OptionalAttribute() */ String Title, 
    /** @attribute OptionalAttribute() */ String DefaultResponse, 
    /** @attribute OptionalAttribute() */ int XPos, 
    /** @attribute OptionalAttribute() */ int YPos
)

JScript

public static function InputBox
 (
    Prompt : String, 
    Title : String, 
    DefaultResponse : String, 
    XPos : int, 
    YPos : int
) : String

パラメータ

Prompt

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

Title

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

DefaultResponse

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

XPos

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

YPos

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

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

解説

詳細については、Visual Basic のトピック「InputBox 関数 (Visual Basic)」を参照してください。

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

1 番目の引数以外の引数を指定するには、式で InputBox 関数を使用する必要があります。位置に関する引数のいずれかを省略した場合、対応するコンマ区切り文字を維持する必要があります。

メモ
InputBox 関数には、SafeTopLevelWindows レベルでの UIPermission が必要です。ただし、部分的に信頼されている状況でこの許可を使用すると、プログラムの実行に影響を及ぼす場合があります。詳細については、「アクセス許可の要求」および「UIPermission クラス」を参照してください。

使用例

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

Visual Basic

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Interaction クラス
Interaction メンバ
Microsoft.VisualBasic 名前空間
その他の技術情報
InputBox 関数 (Visual Basic)
MsgBox 関数 (Visual Basic)
Chr 関数、ChrW 関数