Описание функции | |
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 равным: |
@error | 0 = введённая строка допустима. |
1 = нажата кнопка отмена (Cancel). | |
2 = время ожидания истекло. | |
3 = ошибка открытия окна ввода. Обычно причиной являются неправильные параметры. | |
4 = окно ввода не может быть отображено ни на одном из мониторов. | |
5 = неправильно переданы параметры (width без height или left без top). |
Примечания
Размер окна ввода может быть изменён пользователем, но имеет минимальные размеры 190 x 115 пикселей . По умолчанию, размер окна равен 250 x 190 пикселей .См. также
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] ;; обрамить ссылку из буфера обмена тегами для вставки на сайт, текст ссылки вводится в диалоге