Interaction.InputBox(String, String, String, Int32, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отображает запрос в диалоговом окне, ожидает ввода текста или нажатия кнопки, а затем возвращает строку, содержащую содержимое текстового поля.
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(10)) или сочетания возвращаемого или строкового канала (Chr(Chr(13) и Chr(10)) между каждой строкой.
- Title
- String
Optional.
String выражение, отображаемое в заголовке диалогового окна. Если не указано Title, имя приложения помещается в строку заголовка.
- DefaultResponse
- String
Optional.
String выражение, отображаемое в текстовом поле в качестве ответа по умолчанию, если другие входные данные не указаны. Если не указано DefaultResponse, отображаемое текстовое поле пусто.
- XPos
- Int32
Optional. Числовое выражение, указывающее расстояние от левого края диалогового окна от левого края экрана. Если опущено XPos, диалоговое окно находится в центре по горизонтали.
- YPos
- Int32
Optional. Числовое выражение, указывающее расстояние верхнего края диалогового окна в верхней части экрана. Если опущено YPos, диалоговое окно расположено по вертикали примерно на одну треть пути вниз по экрану.
Возвращаемое значение
Отображает запрос в диалоговом окне, ожидает ввода текста или нажатия кнопки, а затем возвращает строку, содержащую содержимое текстового поля.
Примеры
В этом примере показаны различные способы использования InputBox функции для запроса пользователя ввести значение. Если координаты x и y опущены, диалоговое окно автоматически располагается по центру соответствующих осей. Переменная MyValue содержит значение, введенное пользователем, если пользователь нажимает кнопку "ОК" или нажимает клавишу ВВОД.
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
Комментарии
При нажатии кнопки Отмена возвращается пустая строка.
Чтобы указать больше первого аргумента, необходимо использовать функцию InputBox в выражении. Если вы опустите какие-либо позиционные аргументы, необходимо сохранить соответствующий разделитель запятых.
Note
Функция InputBox требуется UIPermission на SafeTopLevelWindows уровне, что может повлиять на его выполнение в ситуациях с частичным доверием. Дополнительные сведения см. в разделе "Запрос разрешений " и UIPermission .