Отображает приглашение в диалоговом окне, ждет ввода текста или нажатия кнопки пользователем и возвращает значение типа String с содержимым текстового поля.
Синтаксис
InputBox(prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
Функция InputBox имеет следующие аргументы:
| Аргумент | Описание |
|---|---|
| сообщение | Обязательный аргумент. Строковое выражение, отображаемое как сообщение в диалоговом окне. Максимальная длина запроса составляет около 1024 символов в зависимости от ширины используемых символов. Если запрос состоит из нескольких строк, можно разделить строки с помощью символа возврата каретки (Chr(13)), символа канала строк (Chr(10)) или комбинации символов возврата каретки и символов канала строки (Chr(13) & Chr(10)) между каждой строкой. |
| заголовок | Необязательный аргумент. Строковое выражение, отображаемое в заголовке диалогового окна. Если опустить заголовок, имя приложения помещается в строку заголовка. |
| по_умолчанию | Необязательный аргумент. Строковое выражение, отображаемое в текстовом поле как отклик по умолчанию, если не предоставлены другие входные данные. Если опустить значение по умолчанию, текстовое поле будет отображаться пустым. |
| координата_x | Необязательный аргумент. Числовое выражение, которое определяет расстояние по горизонтали от левого края диалогового окна до левого края экрана (в твипах). Если xpos опущен, диалоговое окно будет по горизонтали по центру. |
| координата_y | Необязательный аргумент. Числовое выражение, которое определяет расстояние по вертикали от верхнего края диалогового окна до верхнего края экрана (в твипах). Если значение ypos опущено, диалоговое окно размещается по вертикали примерно на одну треть пути вниз по экрану. |
| файл_справки | Необязательный аргумент. Строковое выражение, определяющее файл, в котором содержится контекстная справка для данного диалогового окна. Если указан файл справки , необходимо также указать контекст . |
| контекст | Необязательный аргумент. Числовое выражение, представляющее собой номер контекста, присвоенный автором справки соответствующему разделу. Если задан контекст , необходимо также указать файл справки . |
Замечания
При указании файла справки и контекста пользователь может нажать клавишу F1 (Windows) или HELP (Macintosh), чтобы просмотреть раздел справки, соответствующий контексту. Некоторые ведущие приложения также автоматически добавляют кнопку "Справка " в диалоговое окно. Если пользователь нажимает кнопку ОК или нажимает клавишу ВВОД, функция InputBox возвращает все, что находится в текстовом поле. Если пользователь нажимает кнопку Отмена, функция возвращает строку нулевой длины ("").
Примечание
Чтобы указать больше первого именованного аргумента, необходимо использовать InputBox в выражении. Чтобы опустить некоторые позиционные аргументы, необходимо включить соответствующий разделитель запятых.
Пример
Примечание
В примерах ниже показано, как использовать эту функцию в модуле Visual Basic для приложений (VBA). Чтобы получить дополнительные сведения о работе с VBA, выберите Справочник разработчика в раскрывающемся списке рядом с полем Поиск и введите одно или несколько слов в поле поиска.
В данном примере показаны различные способы использования функции InputBox для отображения запроса на ввод значения. Если координаты x и y опущены, диалоговое окно автоматически располагается по центру соответствующих осей. Переменная MyValue содержит значение, введенное пользователем, если пользователь нажимает кнопку ОК или нажимает клавишу ВВОД. При нажатии кнопки Отмена возвращается пустая строка.
Dim Message, Title, Default, MyValue
Message = "Enter a value between 1 and 3" ' Set prompt.
Title = "InputBox Demo" ' Set title.
Default = "1" ' Set default.
' Display message, title, and default value.
MyValue = InputBox(Message, Title, Default)
' Use Helpfile and context.
' The Help button is added automatically.
MyValue = InputBox(Message, Title,,,,"DEMO.HLP", 10)
' Display dialog box at position 100, 100.
MyValue = InputBox(Message, Title, Default, 100, 100)