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


InputBox

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

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

Параметры

title Заголовок окна ввода.
prompt Сообщение пользователю, объясняющее, что ему необходимо ввести.
default [необязательный] Значение, которое будет отображено в строке ввода при появлении окна ввода.
password char [необязательный] Символ, на который будут заменяться все вводимые символы. Если необходимо, чтобы отображались именно вводимые символы, передайте в качестве параметра пустой символ Chr(0) (по умолчанию) или пробел в качестве первого символа. Если будет передана строка с несколькими символами, только первый символ будет использован для "маскировки" ввода. Второй и последующий символы строки имеют специальное значение. См. примечания.
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 (см. пример).

Функцию можно подключить через команду exect
Для передачи пустой строки можно воспользоваться ключевым словом Null
Для передачи значения по умолчанию можно воспользоваться ключевым словом Default

См. также

ToolTip, SplashTextOn, _MsgBox, MsgBox, [msgbx], shape, style, dilog, stylp, infbx, infht, posts

Примеры:
 Как создать кнопку?


exect=$var_vbutton=InputBox('Вопрос','Где~~вы~~родились?') GLOBALEXECT<a> ;; пример окна ввода информации

exect=$var_vbutton=InputBox('Вопрос','Где~~вы~~родились?')||$var_input=MsgBox(4096,'Сообщение','$var_button') GLOBALEXECT<a> ;; пример окна ввода информации и вывода в окне сообщения

exect=$var_name=InputBox('Запрос','Введите~~имя~~файла','<info=f*63,62,61*~~-~~*([tc=AP])>')||$var_i='$var_name'?1:_Exit()||_ViewValues($var_name) ;; ввести значение в диалоге, если же диалог закрывается или нажимается кнопка "Отмена", то выход из программы

exect=$var_name=InputBox('Запрос','Введите~~имя~~файла','<info=f*63,62,61*~~-~~*([tc=AP])>') <IF> $var_name = '''' <THEN> toexit <ENDIF> exect=_ViewValues($var_name) ;; ввести значение в диалоге, если же диалог закрывается или нажимается кнопка "Отмена", то выход из программы

exect=$var_name=InputBox('Запрос','Введите~~имя~~файла','<info=f*63,62,61*~~-~~*([tc=AP])>') <IF> $var_name > '''' <THEN> exect=_ViewValues($var_name) <ELSE> toexit <ENDIF> ;; ввести значение в диалоге, если же диалог закрывается или нажимается кнопка "Отмена", то выход из программы

exect=$var_vbutton=InputBox('Обрамление~~ссылки~~тегами~~[url]','Текст~~ссылки','Текст','''',300,140)||$var_i='$var_vbutton'?1:_Exit() bufsr=^^[url=||$$]GLOBALEXECT<1>[/url] ;; обрамить ссылку из буфера обмена тегами для вставки на сайт, текст ссылки вводится в диалоге


© Аверин Андрей для Total Commander Image  Averin-And@yandex.ru