Prompt
Описание
Prompt - оператор запроса ввода от пользователя. Запрашивает значения для строки, массива или числа.
Для подсказки, содержащей больше одного слова, используйте кавычки.
Для строки: в переменную($a) записывается введенная строка. Если выбор не был сделан (нажатие ок без ввода строки) - записывается пустая строка.
Для числа: в переменную(#a) записывается номер выбора. Если выбор не был сделан (нажатие ок без ввода строки) - записывается ноль.
Для массива: в массив(%a) записываются все значения для каждого элемента. Если элемент был выбран - единица, если нет - ноль.
Синтаксис
Привязка к окну: нет.
Работа со свернутым окном: да.
Prompt ([!caption] <line1> [line2] [line3] [line4] [line5] ([timeout]))
Где:
[!caption] - необязательный параметр. Подсказка, начинается с '!'.
<line1> [line2] [line3] [line4] [line5] - набор значений для выбора. Одно или больше.
([timeout]) - таймаут (время для выбора значения), указывается в секундах в круглых скобках.
set $a prompt (подсказка) set #b prompt (выбор1 выбор2 выбор3 выбор4 выбор5) set %с prompt (выбор1 выбор2 выбор3 выбор4 выбор5)
set $a prompt - Запрос на ввод значения. Возвращает в переменную введенное значение.
set #b prompt - Запрос на выбор значения. возвращает номер выбранного значения, либо 0. Выбор подтверждается закрытием окна.
set %с prompt - Запрос на выбор нескольких значений. Возвращает указанный массив, содержащий в первой строке, по столбцам соответствующим номерам значений, либо 1 - если элемент выбран, либо 0.
Положение окна функции 'prompt':
promptpos_x promptpos_y
Примеры
// Пример 1 set #a prompt (первый "второй выбор" третий) msg #a
// Пример 2 set $a prompt (Введите значение) // Может быть как строкой, так и числом msg Введено: $a
// Пример 3
set %a prompt (первый "второй выбор" третий)
// если выбрано 1, иначе 0
msg %a[1] // все значения в одну строку
// значения отдельно
msg %a[1 1] // первое значение
msg %a[1 2] // второе
msg %a[1 3] // третье
// Пример 4 set promptpos_x 100 //установить координату 'Х' для окна Prompt set promptpos_y 100 //установить координату 'Y' для окна Prompt set #b prompt (выбор1 выбор2 выбор3 выбор4 выбор5) msg #b
// Пример 5
// Prompt из массива
set %a [1] 123
set %a [2] 456
set %a [3] 789
set %a [4] abc
set %a [5] def
set $a //очищаем строку
for #i 1 size(%a)
set $a $a %a[#i] //создаём строку из всех элементов массива
end_for
set $b "prompt ($a ())"
set %b [1] "#a"
eval (set %b[1] $b) //выводим prompt
msg #a
End_script
// Пример 6 // Вывод Prompt с подсказкой set $str "Выбрать одно из значений:" // подсказка set #a prompt (!$str Один Два Три) msg #a
// Пример 7 // Вывод Prompt с таймаут set $str "Выбрать одно из значений:" set #a prompt (!$str Один Два Три (5)) // на выбор значения 5 секунд, если выбор не сделан вернёт в переменную '#a' 0. msg #a
Смотрите также
История развития
2.14
Добавил возможность из скрипта запросить значение у пользователя.
'set $a prompt (<подсказка>)'
Запрос на ввод значения. возвращает в переменную введенное значение.
'set #b prompt (<выбор1> <выбор2> [выбор3] [выбор4] [выбор5])'
Запрос на выбор значения. возвращает номер выбранного значения, либо 0. выбор подтверждается закрытием окна..
2.20
Поправил внешний вид формочки 'prompt' и добавил кнопочку 'Ок'.
Поправил 'prompt' на предмет соответствия заявленному функционалу, и добавил возможность выбора нескольких значений:
set $a prompt (подсказка)
Запрос на ввод значения. возвращает в переменную введенное значение.
set #b prompt (выбор1 выбор2 выбор3 выбор4 выбор5)
Запрос на выбор значения. возвращает номер выбранного значения, либо 0. выбор подтверждается закрытием окна.
set %с prompt (выбор1 выбор2 выбор3 выбор4 выбор5)
Запрос на выбор нескольких значений. Возвращает указанный массив, содержащий в первой строке, по столбцам соответствующим номерам значений, либо 1 - если элемент выбран, либо 0 Пример:
set %s prompt (ch1 ch2 ch3 ch4 ch5) set #a size (%s [ 1 ]) // строка всегда одна, но в ней несколько столбцов set #b %s [ 1 #a ] // последний элемент set $c %s [ 1 ] // получим чтото типа 10010, т.е. все элементы сразу.
2.21
Добавил в 'prompt' таймаут ожидания в секундах. Указывается после всех параметров в круглых скобках:
'set #b prompt (ch1 ch2 ch3 [(таймаут)])'
Исправил незначительную ошибку в функции 'prompt'. Не обнулялся массив результатов.
2.27.2
Слегка подправил команду 'prompt':
Исправил вывод подсказки при запросе текстового значения
Добавил закрытие диалогового окна по клавише 'Enter'
Добавил закрытие диалогового окна при выборе значения мышкой
Добавил возможность указать многострочный комментарий с помощью '/n' при запросе строкового значения
Добавил возможность простого выбора числового ответа с клавиатуры
Снял ограничение на 5 элементов выбора
Исправил отображение указанного таймаута ожидания в виде дополнительного пункта
Немного косметики
Если диалоговое окно закрылось по таймауту и в нем ничего не выбрано, то возвращается 0 или пустая строка, иначе - выбранный пункт
Кнопка 'Ок' играет еще более символическую роль чем раньше
2.29
Подправил малость 'prompt'.
Подправил 'prompt', при остановке скрипта открытое окно промпта закрывается.
2.32
Исправил ошибку в команде 'prompt', из-за которой все, что шло после пустых переменных игнорировалось.
Исправил ошибку повторного вызова команды 'prompt', после остановки скрипта с активным окном промпта.
Добавил в 'prompt' возможность выводить не нажимающиеся строки (без чекбоксов) с помощью восклицательного знака в начале строки.
set #s prompt (!Test ! Passed)
Добавил в 'prompt' возможность выводить свой заголовок с помощью восклицательного знака, указанного в начале первой строки.
2.36.2
Добавил переменные положения окна функции 'prompt': 'promptpos_x', 'promptpos_y'. Значения изменяются только для текущего скрипта.
2.37
Починил чтение 'promptpos_x' и 'promptpos_y'.
2.39
Исправил ошибку, возникающую при отсутствии пробела перед скобкой в команде 'prompt'.
2.41
Расширил до 16к строку параметров передаваемую в команду 'prompt'.
Сделал автоматическое определение ширины окна команды 'prompt'.
