Interaction.InputBox(String, String, String, Int32, Int32) Metódus

Definíció

Névtér:

Microsoft.VisualBasic

Szerelvény:

Microsoft.VisualBasic.Core.dll

Forrás:

Interaction.vb

Megjelenik egy üzenet egy párbeszédpanelen, megvárja, amíg a felhasználó beírja a szöveget, vagy rákattint egy gombra, majd visszaad egy sztringet, amely tartalmazza a szövegdoboz tartalmát.

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

Paraméterek

Prompt

String

A párbeszédpanelen üzenetként megjelenő kötelező String kifejezés. A maximális hossz Prompt a használt karakterek szélességétől függően körülbelül 1024 karakter lehet. Ha Prompt egynél több sorból áll, a vonalakat kocsivissza karakterrel (13Chr(), vonalbetöltési karakterrel ()Chr(10)) vagy kocsivissza-/sorbetöltési kombinációval (Chr(13) és Chr(10)) elválaszthatja egymástól.

Title

String

Optional. String kifejezés jelenik meg a párbeszédpanel címsorában. Ha kihagyja Title, az alkalmazás neve a címsorba kerül.

DefaultResponse

String

Optional. String kifejezés jelenik meg a szövegdobozban alapértelmezett válaszként, ha nincs más bemenet. Ha kihagyja DefaultResponse, a megjelenített szövegdoboz üres.

XPos

Int32

Optional. Numerikus kifejezés, amely a párbeszédpanel bal szélének távolságát adja meg a képernyő bal szélétől. Ha kihagyja XPos, a párbeszédpanel vízszintesen középre van adva.

YPos

Int32

Optional. Numerikus kifejezés, amely a párbeszédpanel felső szélének távolságát adja meg a képernyő tetejétől. Ha kihagyja YPos, a párbeszédpanel függőlegesen a képernyő felé vezető út körülbelül egyharmadát függőlegesen helyezi el.

Válaszok

String

Megjelenik egy üzenet egy párbeszédpanelen, megvárja, amíg a felhasználó beírja a szöveget, vagy rákattint egy gombra, majd visszaad egy sztringet, amely tartalmazza a szövegdoboz tartalmát.

Példák

Ez a példa azt mutatja be, hogyan lehet a InputBox függvény használatával arra kérni a felhasználót, hogy adjon meg egy értéket. Ha kihagyja az x és az y pozíciót, a párbeszédpanel automatikusan a megfelelő tengelyek közepére kerül. A változó MyValue tartalmazza a felhasználó által megadott értéket, ha a felhasználó az OK gombra kattint, vagy lenyomja az ENTER billentyűt.

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

Megjegyzések

Ha a felhasználó a Mégse gombra kattint, a program egy nulla hosszúságú karakterláncot ad vissza.

Ha az első argumentumnál többet szeretne megadni, a függvényt InputBox egy kifejezésben kell használnia. Ha kihagy bármilyen pozícióargumentumot, meg kell őriznie a megfelelő vesszőelválasztót.

Note

A InputBox függvény megköveteli UIPermission a SafeTopLevelWindows szintet, ami befolyásolhatja a részleges megbízhatósági helyzetekben történő végrehajtását. További információ: Engedélyek kérése és UIPermission .

Lásd még

• MsgBox(Object, MsgBoxStyle, Object)
• Chr(Int32)
• ChrW(Int32)