Interaction.InputBox(String, String, String, Int32, Int32) Metoda

Definicja

Przestrzeń nazw:
Microsoft.VisualBasic
Zestaw:
Microsoft.VisualBasic.dll

Wyświetla monit w oknie dialogowym, czeka, aż użytkownik wprowadzi tekst lub kliknie przycisk, a następnie zwróci ciąg zawierający zawartość pola tekstowego.

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

Parametry

Prompt
String

Wymagane String wyrażenie wyświetlane jako komunikat w oknie dialogowym. Maksymalna długość Prompt to około 1024 znaków, w zależności od szerokości używanych znaków. Jeśli Prompt składa się z więcej niż jednego wiersza, można oddzielić wiersze znakiem powrotu karetki (Chr(13)), znakiem zestawienia wiersza (Chr(10)) lub kombinacją zestawienia karetki powrotnej/linii (Chr(13) i Chr(10)) między poszczególnymi wierszami.

Title
String

Optional. String wyrażenie wyświetlane na pasku tytułu okna dialogowego. Jeśli pominięto Title, nazwa aplikacji zostanie umieszczona na pasku tytułu.

DefaultResponse
String

Optional. String wyrażenie wyświetlane w polu tekstowym jako domyślna odpowiedź, jeśli nie podano żadnych innych danych wejściowych. Jeśli pominięto DefaultResponse, wyświetlane pole tekstowe jest puste.

XPos
Int32

Optional. Wyrażenie liczbowe określające odległość lewej krawędzi okna dialogowego od lewej krawędzi ekranu. Jeśli pominięto XPos, okno dialogowe jest wyśrodkowane w poziomie.

YPos
Int32

Optional. Wyrażenie liczbowe określające odległość górnej krawędzi okna dialogowego w górnej części ekranu. YPosJeśli pominięto , okno dialogowe jest rozmieszczone w pionie około jednej trzeciej drogi w dół ekranu.

Zwraca

String

Wyświetla monit w oknie dialogowym, czeka, aż użytkownik wprowadzi tekst lub kliknie przycisk, a następnie zwróci ciąg zawierający zawartość pola tekstowego.

Przykłady

W tym przykładzie przedstawiono różne sposoby używania InputBox funkcji w celu monitowania użytkownika o wprowadzenie wartości. Jeśli pozycja x i y zostaną pominięte, okno dialogowe zostanie automatycznie wyśrodkowane dla odpowiednich osi. Zmienna MyValue zawiera wartość wprowadzoną przez użytkownika, jeśli użytkownik kliknie przycisk OK lub naciśnie klawisz 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

Uwagi

Jeśli użytkownik kliknie przycisk Anuluj, zostanie zwrócony ciąg znaków o zerowej długości.

Aby określić więcej niż pierwszy argument, należy użyć InputBox funkcji w wyrażeniu. Jeśli pominięto jakiekolwiek argumenty pozycyjne, należy zachować odpowiedni ogranicznik przecinka.

Note

Funkcja InputBox wymaga UIPermission na SafeTopLevelWindows poziomie, co może mieć wpływ na jego wykonywanie w sytuacjach częściowego zaufania. Aby uzyskać więcej informacji, zobacz Żądanie uprawnień i UIPermission .

Dotyczy

Zobacz też