Функция InputBox

         Описание функции


InputBox

Отображает окно ввода, выдающее запрос пользователю на ввод строки.

InputBox ( "title", "prompt" [, "default" [, "password char" [, width = -1 [, height = -1 [, left = Default [, top = Default [, timeout = 0 [, hwnd ]]]]]]]] )

Параметры

title Заголовок окна ввода.
prompt Сообщение пользователю, объясняющее, что ему необходимо ввести.
default [необязательный] Значение, которое будет отображено в строке ввода при появлении окна ввода.
password char [необязательный] Символ, на который будут заменяться все вводимые символы. Если необходимо, чтобы отображались именно вводимые символы, передайте в качестве параметра пустую строку ("") (по умолчанию) или пробел в качестве первого символа. Если будет передана строка с несколькими символами, только первый символ будет использован для "маскировки" ввода. Второй и последующий символы строки имеют специальное значение. См. примечания.
width [необязательный] Ширина окна (по умолчанию -1).
height [необязательный] Высота окна (по умолчанию -1).
left [необязательный] Координата левого края окна (по умолчанию Default, чтобы центрировать окно).
top [необязательный] Координата верхнего края окна (по умолчанию Default, чтобы центрировать окно).
timeout [необязательный] Время ожидания (в секундах), по истечении которого InputBox будет автоматически закрыт (по умолчанию 0, что означает, что время отображения не ограничено).
hwnd [необязательный] Дескриптор родительского окна. Предотвращает доступ к родительскому окну, пока существует InputBox.

Возвращаемое значение

Успех:Возвращает введённую строку.
Ошибка:Возвращает "" (пустую строку) и устанавливает значение @error равным:
@error0 = введённая строка допустима.
1 = нажата кнопка отмена (Cancel).
2 = время ожидания истекло.
3 = ошибка открытия окна ввода. Обычно причиной являются неправильные параметры.
4 = окно ввода не может быть отображёно ни на одном из мониторов.
5 = неправильно переданы параметры (width без height или left без top).

Примечания

Размер окна ввода может быть изменён пользователем, но имеет минимальные размеры 190 x 115 пикселей . По умолчанию, размер окна равен 250 x 190 пикселей .

Длина возвращаемой строки не превышает 254 символа и, если введённая строка содержит символы возврата каретки или перевода строки, результат будет обрезан до первого появления этих символов.

Второй и последующий символы параметра password предназначены для ограничения пользовательского ввода. Используйте пробел в качестве первого символа, чтобы вводимые символы по-прежнему отображались. Использование символа M (англ.) в качестве второго символа параметра указывает что ввод какого-либо значения принудителен (англ. Mandatory). Ничего не случится при нажатии кнопки Ok, если в строке ввода нет какого-либо значения. В этом случае окно не будет закрыто.

Можно также указать максимальную длину строки ввода. Для этого служат последние символы параметра password (см. пример).

См. также

MsgBox

Пример

; Этот пример содержит параметры по умолчанию.
; $answer = InputBox("Заголовок", "Пояснение", "Текст поля ввода", "", -1, -1, Default, Default, 0)

; Диалоговое окно появится в левом верхнем углу, отображая вводимые символы как есть.
$answer = InputBox("Вопрос", "Где вы родились?", "Планета Земля", "", -1, -1, 0, 0)

; Просит пользователя ввести пароль, вместо символов отображаются звёздочки. Не забудьте проверить это!
$passwd = InputBox("Проверка безопасности", "Введите пароль.", "", "*")

; Просит пользователя ввести 1 или 2 символа в поле ввода. Символ M в параметре пароля, означает, что пустая строка не принимаются и при нажатии OK ничего не произойдёт; символ 2 означает, что невозможно ввести более 2-х символов.
$value = InputBox("Тестирование", "Введите 1 или 2 символа.", "", " M2")