диалог - Онлайн в облаке

ПРОГРАММА:

ИМЯ

dialog - отображать диалоговые окна из сценариев оболочки

СИНТАКСИС

Диалог --Чисто
Диалог --create-rc файл
Диалог --print-maxsize
Диалог общие варианты коробки-варианты

ОПИСАНИЕ

Диалог это программа, которая позволит вам задавать различные вопросы или отображать сообщения
с помощью диалоговых окон из сценария оболочки. Реализованы эти типы диалоговых окон.
(хотя не все обязательно скомпилированы в Диалог):

список сборки, календарь, контрольный список, Dselect, поле редактирования, форма, fвыбрать, калибр, инфобокс,
поле ввода, меню ввода, МЕНЮ, смешанная форма, смешанный, MsgBox (сообщение), PasswordBox,
форма пароля, Пауза, пргбокс, программа, прогрессбокс, радиолист, диапазон, хвостовой ящик,
хвостовой ящикbg, текстовое поле, ящик времени, в виде деревакачества да нет (да нет).

В сценарий можно поместить более одного диалогового окна:

· Использовать "--и-виджет"токен, чтобы заставить Диалог чтобы перейти к следующему диалогу, если вы
нажали ESC для отмены, или

· Просто добавьте жетоны для следующего диалогового окна, образуя цепочку. Диалог перестает цепляться
когда код возврата из диалога отличен от нуля, например, Отмена или Нет (см. ДИАГНОСТИКА).

Некоторые виджеты, например, контрольный список, будут писать текст в Диалогвывод. Обычно это
стандартная ошибка, но есть варианты для ее изменения: "--output-fd,--stderr" а также
"--stdout". Текст не записывается, если нажата кнопка Отмена (или ESC); Диалог выходы
немедленно в этом случае.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Все варианты начинаются с "--"(два дефиса ASCII для пользователей систем
с ненормальной поддержкой локали).

А "--"сам по себе используется как escape, т. е. следующий токен в командной строке не
рассматривал как вариант.
Диалог --заглавие -- --Нет an вариант

"--args"опция говорит Диалог чтобы вывести стандартные параметры командной строки
ошибка. Это полезно при отладке сложных сценариев с использованием символа "--, а также--файл", поскольку
командная строка может быть переписана по мере их расширения.

"--файл"опция говорит Диалог для чтения параметров из файла, указанного в качестве его значения.
Диалог --файл файл параметров
Пробелы, не заключенные в двойные кавычки, отбрасываются (используйте обратную косую черту для цитирования одиночных кавычек.
символы). Результат вставляется в командную строку, заменяя "--файл" И его
стоимость опциона. С этого момента возобновляется интерпретация командной строки. Если
файл параметров начинается с "&", Диалог интерпретирует следующий текст как дескриптор файла
номер, а не имя файла.

Общий Опции
Большинство общих параметров сбрасываются перед обработкой каждого виджета.

--ascii-линии
Вместо того, чтобы рисовать графические линии вокруг прямоугольников, нарисуйте ASCII "+" и "-" в одном и том же
место. Смотрите также "--нет строк".

- аспект соотношение
Это дает вам некоторый контроль над размерами коробки при использовании автоматического изменения размера.
(указав 0 для высоты и ширины). Он представляет ширину / высоту. По умолчанию
9, что означает ширину 9 символов на каждую строку высотой.

--backtitle подзаголовок
Определяет подзаголовок строка, которая будет отображаться на заднем плане, в верхней части
экран.

--начинать y x
Укажите положение левого верхнего угла диалогового окна на экране.

--cancel-метка string
Заменить метку, используемую для кнопок «Отмена».

--Чисто
Очищает экран виджета, оставляя только фон screen_color. Используйте это, когда
вы комбинируете виджеты с "--и-виджет"чтобы стереть содержимое предыдущего виджета
на экране, поэтому его не будет видно под содержимым следующего виджета.
Поймите это как дополнение к "- окно-хранилище". Чтобы сравнить эффекты, используйте
эти:

Видны все три виджета, эффект лестницы в порядке 1,2,3:

диалог \
--begin 2 2 --yesno "" 0 0 \
--and-widget --begin 4 4 --yesno "" 0 0 \
--and-widget --begin 6 6 --yesno "" 0 0

Остается видимым только последний виджет:

диалог \
--clear --begin 2 2 --yesno "" 0 0 \
--and-widget --clear --begin 4 4 --yesno "" 0 0 \
--and-widget --begin 6 6 --yesno "" 0 0

Видны все три виджета, эффект лестницы в порядке 3,2,1:

диалог \
--keep-window --begin 2 2 --yesno "" 0 0 \
--and-widget --keep-window --begin 4 4 --yesno "" 0 0 \
--and-widget --begin 6 6 --yesno "" 0 0

Видны первый и третий виджеты, эффект лестницы, порядок 3,1:

диалог \
--keep-window --begin 2 2 --yesno "" 0 0 \
--and-widget --clear --begin 4 4 --yesno "" 0 0 \
--and-widget --begin 6 6 --yesno "" 0 0

Обратите внимание: если вы хотите восстановить исходные цвета консоли и отправить курсор домой
после выхода из диалоговой программы используйте Очистить (1) команда.

--цвета
Интерпретировать встроенные последовательности "\ Z" в текст диалога следующим символом:
что говорит Диалог чтобы установить цвета или атрибуты видео:

· 0–7 - это номера цветов ANSI, используемые в проклятиях: черный, красный, зеленый,
желтый, синий, пурпурный, голубой и белый соответственно.

· Жирный шрифт устанавливается буквой «b», сбрасывается буквой «B».

· Реверс устанавливается с помощью «r», сбрасывается с помощью «R».

· Подчеркивание устанавливается буквой «u», сбрасывается буквой «U».

· Настройки являются совокупными, например, "\ Zb \ Z1" выделяет следующий текст жирным шрифтом.
(возможно, ярко-красный).

· Восстановите нормальные настройки с помощью "\ Zn".

--колонка-разделитель string
Сказать Диалог для разделения данных для радио / флажков и меню по вхождению
заданной строки и для выравнивания разделенных данных по столбцам.

--cr-обернуть
Интерпретируйте встроенные символы новой строки в тексте диалога как новую строку на экране.
В противном случае Диалог будет переносить строки только там, где это необходимо, чтобы поместиться внутри текстового поля.

Несмотря на то, что с помощью этого вы можете управлять разрывами строк, Диалог по-прежнему будет переносить любые строки
которые слишком длинные для ширины коробки. Без cr-wrap макет вашего
текст может быть отформатирован так, чтобы он хорошо смотрелся в исходном коде вашего скрипта без
влияя на то, как он будет выглядеть в диалоге.

Смотрите также- без обвала, а также--отделка" параметры.

--create-rc файл
После появления Диалог поддерживает конфигурацию во время выполнения, это можно использовать для дампа образца
файл конфигурации в файл, указанный файл.

--Формат даты формат
Если хост предоставляет стрфтайм, этот параметр позволяет указать формат файла
дата, напечатанная для --календарь виджет. Время суток (час, минута, секунда)
текущее местное время.

- по умолчанию
Сделайте значение по умолчанию для да нет коробка а Нет. Таким же образом сделайте кнопку по умолчанию
виджетов, которые предоставляют "ОК" и "Отмена" Отмена. Если "--nocancel"Или"--визит-
пункты"даны эти параметры отменяют это, делая кнопку по умолчанию всегда
«Да» (внутренне то же, что и «ОК»).

- кнопка по умолчанию string
Установите кнопку по умолчанию (предварительно выбранную) в виджете. При предварительном выборе кнопки
скрипт позволяет пользователю просто нажать Enter пройти через
диалог с минимальным взаимодействием.

Значение параметра - это имя кнопки: ok, Да, отменить, нет, помощь or дополнительно.

Обычно по умолчанию используется первая кнопка в каждом виджете. Первая показанная кнопка - это
определяется виджетом вместе с "- закусывать, а также--nocancel параметры. Если
эта опция не указана, кнопка по умолчанию не назначена.

--элемент по умолчанию string
Установите элемент по умолчанию в контрольном списке, форме или поле меню. Обычно первый элемент в
коробка по умолчанию.

--exit-метка string
Заменить метку, используемую для кнопок «ВЫХОД».

--extra-кнопка
Показать дополнительную кнопку между кнопками «ОК» и «Отмена».

--extra-метка string
Заменить метку, используемую для кнопок "Extra". Примечание. Для виджетов меню ввода это
по умолчанию "Переименовать".

--Помогите Печатает справочное сообщение на стандартный вывод и закрывается. Справочное сообщение также
печатается, если не указаны параметры или задан нераспознанный параметр.

- кнопка помощи
Показывать кнопку справки после кнопок «ОК» и «Отмена», т.е. в контрольном списке, радиолистке
и окна меню.

При выходе статус возврата будет указывать на то, что была нажата кнопка «Справка». Диалог
также напишет сообщение на свой выход после токена «HELP»:

· Если "--item-помощь", будет написан текст справки по пункту.

· В противном случае будет записан тег товара (первое поле).

Вы можете использовать --help-теги вариант и / или установить среду DIALOG_ITEM_HELP
переменная для изменения этих сообщений и статуса выхода.

--help-метка string
Заменить метку, используемую для кнопок «Справка».

--help-статус
Если выбрана кнопка справки, записывает контрольный список, радиолист или форму информации
после пункта справки "HELP" информация. Это может быть использовано для реконструкции состояния
контрольного списка после обработки запроса о помощи.

--help-теги
Измените сообщения, написанные при выходе для - кнопка помощи делая их всегда просто
тег элемента. Это не влияет на код статуса выхода.

--hfile имя файла
Отобразите данный файл с помощью текстового поля, когда пользователь нажимает F1.

--hline string
Отобразите данную строку по центру внизу виджета.

- игнорировать
Игнорировать варианты, которые Диалог не узнает. Некоторые известные, такие как
"--икона"все равно игнорируются, но это лучший выбор для совместимости с
другие реализации.

--input-fd fd
Прочитать ввод с клавиатуры из заданного файлового дескриптора. Большинство Диалог сценарии читаются из
стандартный ввод, но виджет датчика читает канал (что всегда стандартно
Вход). Некоторые конфигурации не работают должным образом, когда Диалог пытается снова открыть
Терминал. Используйте эту опцию (с соответствующим манипулированием файловыми дескрипторами), если ваш
сценарий должен работать в такой среде.

--ненадежный
Делает виджет паролей более удобным, но менее безопасным, отображая звездочки для каждого
характер.

--изо-неделя
Установите начальную точку для номера недели, указанного в "--календарьвариант
согласно ISO-8601, который начинается с первой недели, которая включает
Четверг в январе.

--item-помощь
Интерпретируйте данные тегов для контрольного списка, радиолиста и окон меню, добавив столбец
который отображается в нижней строке экрана для текущего выбранного
пункт.

- храните
При построении с Ncurses, Диалог обычно проверяет, работает ли он в
Xterm, и в этом случае пытается подавить строки инициализации, которые
переключить на альтернативный экран. Переключение между обычным и альтернативным
экранов визуально отвлекает от скрипта, который запускается Диалог несколько раз. Использовать
этот вариант, чтобы разрешить Диалог использовать эти строки инициализации.

- окно-хранилище
Обычно когда Диалог выполняет несколько хвостовой ящикbg виджеты, подключенные "--и-
виджет", старый виджет удаляется с экрана, закрашивая его. Используйте это
возможность подавить эту перекраску.

На выходе Диалог перерисовывает все виджеты, отмеченные знаком "--хранить-
окно", даже если они не хвостовой ящикbg виджеты. Это заставляет их перекрашивать
в обратном порядке. См. Обсуждение "--Чисто"вариант для примеров.

- последний ключ
При выходе сообщите последний ключ, который ввел пользователь. Это ключевой код проклятия
а не символ или буквальный символ. Он может использоваться скриптами для
различать два ключа, которые связаны с одним и тем же действием.

--max-ввод размер
Ограничьте входные строки заданным размером. Если не указано, ограничение составляет 2048.

--нет-отмены

--nocancel
Отключите кнопку «Отмена» в режимах контрольного списка, поля ввода и окна меню. Сценарий
все еще можно проверить, нажал ли пользователь клавишу ESC, чтобы отменить, чтобы выйти.

- без обвала
Обычная стоимость Диалог преобразует табуляции в пробелы и сокращает несколько пробелов до одного
пространство для текста, который отображается в окнах сообщений и т. д. Используйте эту опцию, чтобы
отключите эту функцию. Обратите внимание, что Диалог по-прежнему будет переносить текст при условии "--кр-
заворачивать, а также--отделка" параметры.

--нет товаров
Некоторые виджеты (контрольный список, меню ввода, радиосписок, меню) отображают список с двумя
столбцы («тег» и «элемент», т. е. «описание»). Эта опция сообщает Диалог в
читать более короткие строки, опуская «элемент» в списке. Это иногда
полезно, например, если теги предоставляют достаточно информации.

Смотрите также --без тегов. Если даны оба варианта, этот игнорируется.

--без убийств
Сообщает Диалог поставить хвостовой ящикbg поле в фоновом режиме, распечатав его идентификатор процесса в
Диалогвывод. SIGHUP отключен для фонового процесса.

--без метки string
Заменить метку, используемую для кнопок «Нет».

--нет строк
Вместо того, чтобы рисовать линии вокруг квадратов, рисуйте пробелы в одном и том же месте. Смотрите также
"--ascii-линии".

- без мыши
Не включайте мышь.

--no-nl-расширить
Не преобразовывайте подстроки «\ n» текста сообщения / подсказки в буквальные символы новой строки.

--нет-ок

- закусывать Отключите кнопку «ОК» в режимах контрольного списка, поля ввода и окна меню. Скрипт может
по-прежнему проверьте, нажал ли пользователь клавишу «Enter», чтобы принять данные.

--без тени
Подавление теней, которые будут отображаться справа и внизу каждого диалогового окна.

--без тегов
Некоторые виджеты (контрольный список, меню ввода, радиосписок, меню) отображают список с двумя
столбцы («тег» и «описание»). Тег полезен для написания сценариев, но не может
помочь пользователю. В --без тегов опция (из Xdialog) может использоваться для подавления
столбец тегов с дисплея. в отличие от --нет товаров вариант, это не
влияют на данные, считываемые из сценария.

Xdialog не отображает столбец тегов для аналогичного списка сборки и древовидного представления.
виджеты; Диалог делает то же самое.

Обычная стоимость Диалог позволяет быстро переходить к записям в отображаемом списке,
соответствие одного символа первому символу тега. Когда --без тегов
предоставляется вариант, Диалог совпадает с первым символом описания. В
в любом случае соответствующий символ выделяется.

--ok-метка string
Заменить метку, используемую для кнопок «ОК».

--output-fd fd
Прямой вывод в указанный файловый дескриптор. Самый Диалог скрипты пишут в
стандартная ошибка, но сообщения об ошибках также могут быть написаны там, в зависимости от вашего
скрипты.

--разделитель string

- выход-разделительstring
Укажите строку, которая будет разделять вывод на Диалогвывод из контрольных списков,
а не новую строку (для - раздельный вывод) или пробел. Это относится и к другим
виджеты, такие как формы и поля редактирования, которые обычно используют новую строку.

--print-maxsize
Выведите максимальный размер диалоговых окон, т. Е. Размер экрана, чтобы Диалогвывод.
Его можно использовать отдельно, без других опций.

- размер отпечатка
Печатает размер каждого диалогового окна на Диалогвывод.

--print-версия
Печать Диалогверсия для Диалогвывод. Его можно использовать отдельно, без других
опции. Это не вызывает Диалог выйти сам по себе.

цитируется
Обычная стоимость Диалог цитирует строки, возвращаемые контрольным списком, а также справку по элементам
текст. Используйте эту опцию, чтобы заключить в кавычки все строковые результаты.

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

- раздельный вывод
Для некоторых виджетов (список сборки, контрольный список, древовидное представление) выводить результат по одной строке в
раз, без цитирования. Это облегчает синтаксический анализ другой программой.

--отдельный виджет string
Укажите строку, которая будет разделять вывод на Диалогвывод каждого виджета.
Это используется для упрощения анализа результата диалога с несколькими виджетами. Если
эта опция не указана, разделительной строкой по умолчанию является символ табуляции.

--тень
Нарисуйте тень справа и внизу каждого диалогового окна.

- одинарные кавычки
При необходимости используйте одинарные кавычки (и без кавычек, если они не нужны) для вывода
контрольный список, а также текст справки по пункту. Если этот параметр не установлен, Диалог использования
двойные кавычки вокруг каждого элемента. В любом случае, Диалог добавляет обратную косую черту, чтобы сделать
вывод полезен в сценариях оболочки.

- размер-ошибка
Проверьте полученный размер диалогового окна, прежде чем пытаться его использовать, распечатывая
результирующий размер, если он больше экрана. (Эта опция устарела, так как
проверяются все вызовы нового окна).

--спать сек
Спящий режим (задержка) на заданное количество секунд после обработки диалогового окна.

--stderr
Прямой вывод в стандартную ошибку. Это значение по умолчанию, поскольку обычно curses
записывает обновления экрана в стандартный вывод.

--stdout
Прямой вывод на стандартный вывод. Эта опция предусмотрена для совместимости
с Xdialog, однако использовать его в переносимых скриптах не рекомендуется, так как curses
обычно выводит обновления экрана на стандартный вывод. Если вы воспользуетесь этой опцией,
Диалог пытается повторно открыть терминал, чтобы он мог писать на дисплей. В зависимости от
на платформе и в вашей среде, это может привести к сбою.

--tab-правильно
Преобразуйте каждый символ табуляции в один или несколько пробелов (для текстовое поле виджет; в противном случае
в единое пространство). В противном случае вкладки отображаются в соответствии с библиотекой curses.
интерпретация.

--tab-len n
Укажите количество пробелов, которые занимает символ табуляции, если "--tab-правильно"
предоставляется вариант. По умолчанию - 8. Этот параметр действует только для текстовое поле
виджет.

- формат времени формат
Если хост предоставляет стрфтайм, этот параметр позволяет указать формат файла
время напечатано для --таймбокс виджет. Значения дня, месяца, года в этом случае
относятся к текущему местному времени.

- тайм-аут сек
Тайм-аут (выход с кодом ошибки), если пользователь не ответил в течение заданного количества
секунд. Тайм-аут в ноль секунд игнорируется.

Этот параметр игнорируется символом "--Пауза"виджет. Он также отменяется, если
задний план "--tailboxbg"используется для настройки нескольких одновременных виджетов.

--заглавие название
Определяет название строка, которая будет отображаться в верхней части диалогового окна.

--след имя файла
записывает параметры командной строки, нажатия клавиш и другую информацию в указанный
файл. Если Диалог читает файл конфигурации, он также регистрируется. Трубопроводный ввод в
калибр виджет зарегистрирован. Используйте control / T, чтобы записать изображение текущего диалога
окно.

- начало недели день
устанавливает начальный день недели, используемый в "--календарь"вариант. день
параметр может быть

· Число (от 0 до 6, с воскресенья по субботу с использованием POSIX) или

· Специальное значение "locale" (работает с системами, использующими glibc, обеспечивая
расширение до местный команды, первый_буднийдень стоимость).

· Строка, соответствующая одному из сокращений дня недели, показанных в
календарь виджет, например «Пн» для «понедельника».

Ассоциация Диалог программа специально обрабатывает некоторые параметры командной строки и удаляет их из
список параметров по мере их обработки. Например, если первый вариант - --след,
затем это обрабатывается (и удаляется) перед Диалог инициализирует дисплей.

--отделка исключить начальные пробелы, обрезать буквальные символы новой строки и повторяющиеся пробелы из сообщения
текст.

Смотрите также--cr-обернуть, а также- без обвала" параметры.

--версия
Печать Диалогверсия для стандартного вывода и закрывается. Смотрите также "--Распечатать-
версия".

--посещения
Измените переход по вкладкам контрольного списка, радиолиста, меню и меню ввода, чтобы включить
список пунктов как одно из состояний. Это полезно в качестве наглядного пособия, т. Е.
Положение курсора помогает некоторым пользователям.

Когда задана эта опция, курсор изначально помещается в список.
К элементам списка применяются сокращения (первая буква тега). Если вы перейдете к
ряду кнопок к кнопкам применяются сокращения.

--yes-метка string
Заменить метку, используемую для кнопок «Да».

Коробка Опции
Все диалоговые окна имеют как минимум три параметра:

текст заголовок или содержимое коробки.

высота высота диалогового окна.

ширина ширина диалогового окна.

Остальные параметры зависят от типа бокса.

--список_сборок текст высота ширина высота списка [ день пункт статус ] ...
A список сборки диалоговое окно отображает два списка, расположенных рядом. Список слева показывает
невыбранные элементы. В списке справа показаны выбранные элементы. Как предметы
выбранные или невыделенные, они перемещаются между списками.

Используйте возврат каретки или кнопку «ОК», чтобы принять текущее значение в
выбранное окно и выйдите. Результаты записываются в порядке, отображаемом в
выбранное окно.

Начальное состояние включения / выключения каждой записи определяется статус.

Диалог ведет себя как МЕНЮ, С использованием --посещения контролировать, есть ли
Курсор может посещать списки напрямую.

· Если --посещения не задан, переход по табуляции использует два состояния (ОК / Отмена).

· Если --посещения задано, обход табуляции использует четыре состояния
(Влево / Вправо / ОК / Отмена).

Так или иначе --посещения задано, можно перемещать выделение между
два списка с использованием клавиш по умолчанию «^» (левый столбец) и «$» (правый столбец).

При выходе список день строки тех записей, которые включены, будут
напечатано на Диалогвывод.

Если "- раздельный вывод"опция не указана, строки будут заключены в кавычки как
необходимо, чтобы сценарии легко разделяли их. По умолчанию это использует
двойные кавычки. Смотрите "- одинарные кавычки"опция, которая изменяет цитирование
поведение.

--календарь текст высота ширина день месяц год
A календарь Поле отображает месяц, день и год в отдельно настраиваемых окнах. Если
значения дня, месяца или года отсутствуют или отрицательны, текущая дата
используются соответствующие значения. Вы можете увеличивать или уменьшать любой из них, используя
стрелки влево, вверх, вправо и вниз. Используйте стиль vi h, j, k и l для перемещения
вокруг массива дней в месяце. Используйте вкладку или обратную вкладку для перемещения между окнами.
Если год задан как ноль, текущая дата используется в качестве начального значения.

При выходе дата печатается в формате день / месяц / год. Формат может быть
переопределено с помощью --Формат даты опцию.

- контрольный список текст высота ширина высота списка [ день пункт статус ] ...
A контрольный список коробка похожа на МЕНЮ коробка; есть несколько записей, представленных в
форма меню. Другое отличие состоит в том, что вы можете указать, какая запись
выбранный в данный момент, установив его статус в on. Вместо выбора одной записи
среди записей каждая запись может быть включена или отключена пользователем. Начальный
состояние включения / выключения каждой записи определяется статус.

При выходе список день строки тех записей, которые включены, будут
напечатано на Диалогвывод.

Если "- раздельный вывод"опция не указана, строки будут заключены в кавычки как
необходимо, чтобы сценарии легко разделяли их. По умолчанию это использует
двойные кавычки. Смотрите "- одинарные кавычки"опция, которая изменяет цитирование
поведение.

--dselect Путь файла высота ширина
В диалоговом окне выбора каталога отображается окно ввода текста, в котором вы можете ввести
каталог, а выше - окна с именами каталогов.

Здесь Путь файла может быть путем к файлу, и в этом случае в окне каталога будет отображаться
содержимое пути и окно ввода текста будут содержать предварительно выбранные
каталог.

Для перемещения между окнами используйте табуляцию или клавиши со стрелками. В окне каталога
используйте клавиши со стрелками вверх / вниз для прокрутки текущего выбора. Используйте клавишу пробела, чтобы
скопировать текущий выбор в окно ввода текста.

Ввод любых печатных символов переключает фокус на окно ввода текста, вводя
этот символ, а также прокрутку окна каталога до ближайшего совпадения.

Используйте возврат каретки или кнопку «ОК», чтобы принять текущее значение в тексте.
входное окно и выход.

При выходе содержимое окна ввода текста записывается в Диалогвывод.

- редактировать Путь файла высота ширина
В диалоговом окне редактирования отображается копия файла. Вы можете отредактировать его, используя
возврат на одну позицию, удалять и клавиши курсора для исправления опечаток. Он также признает
pageup / pagedown. в отличие от --поле ввода, вы должны перейти к «ОК» или «Отмена»
кнопки, чтобы закрыть диалог. Нажатие клавиши «Ввод» внутри поля разделит
соответствующая строка.

При выходе содержимое окна редактирования записывается в Диалогвывод.

--форма текст высота ширина высота формы [ этикетка y x пункт y x флен Илен ] ...
Ассоциация форма диалоговое окно отображает форму, состоящую из меток и полей, которые
размещается в прокручиваемом окне по координатам, указанным в скрипте. Поле
флен и длина ввода Илен скажите, какой длины может быть поле. Первый
определяет длину, отображаемую для выбранного поля, а последнее определяет
допустимая длина данных, вводимых в поле.

· Если флен равно нулю, соответствующее поле изменить нельзя. и содержание
поля определяют отображаемую длину.

· Если флен отрицательно, соответствующее поле нельзя изменить, и отрицательный
Значение флен используется как отображаемая длина.

· Если Илен равен нулю, он установлен на флен.

Используйте стрелки вверх / вниз (или control / N, control / P) для перемещения между полями. Используйте вкладку, чтобы
перемещаться между окнами.

При выходе содержимое полей формы записывается в Диалогвывод, каждое поле
разделены новой строкой. Текст, используемый для заполнения нередактируемых полей (флен ноль или
отрицательный) не выписывается.

--fselect Путь файла высота ширина
Ассоциация fвыбрать (выбор файла) отображает окно ввода текста, в котором вы можете
введите имя файла (или каталог), а над ним два окна с именами каталогов и
имена файлов.

Здесь Путь файла может быть путем к файлу, и в этом случае окна файлов и каталогов будут
отобразить содержимое пути, и окно ввода текста будет содержать
предварительно выбранное имя файла.

Для перемещения между окнами используйте табуляцию или клавиши со стрелками. В каталоге или
окна имени файла, используйте клавиши со стрелками вверх / вниз для прокрутки текущего выбора. Использовать
пробел, чтобы скопировать текущий выбор в окно ввода текста.

Ввод любых печатных символов переключает фокус на окно ввода текста, вводя
этот символ, а также прокрутить окна каталога и имени файла до
ближайший матч.

Набрав пробел символ силы Диалог для завершения текущего имени (до
точка, где может быть совпадение с более чем одной записью).

Используйте возврат каретки или кнопку «ОК», чтобы принять текущее значение в тексте.
входное окно и выход.

При выходе содержимое окна ввода текста записывается в Диалогвывод.

--измерять текст высота ширина [процентов]
A калибр В нижней части окна отображается метр. Измеритель показывает
процент. Новые проценты считываются из стандартного ввода, по одному целому числу в строке.
Счетчик обновляется, чтобы отображать каждый новый процент. Если стандартный ввод читает
строка "XXX", тогда первая следующая строка принимается как целое число в процентах,
затем последующие строки до другого «XXX» используются для нового приглашения. Датчик
завершается при достижении EOF на стандартном вводе.

Ассоциация процент значение обозначает начальный процент, отображаемый в глюкометре. Если не
указано, это ноль.

При выходе текст не записывается Диалогвывод. Виджет не принимает никаких данных, поэтому
статус выхода всегда в порядке.

--инфобокс текст высота ширина
An info коробка в основном сообщение коробка. Однако в этом случае Диалог выйдет
сразу после отображения сообщения пользователю. Экран не очищается
когда Диалог выход, так что сообщение останется на экране до тех пор, пока
Сценарий оболочки очищает его позже. Это полезно, если вы хотите сообщить пользователю, что
некоторые операции продолжаются, для завершения которых может потребоваться некоторое время.

При выходе текст не записывается Диалогвывод. Возвращается статус выхода ОК.

--поле ввода текст высота ширина [в этом]
An вход поле полезно, когда вы хотите задать вопросы, требующие от пользователя
введите строку в качестве ответа. Если предоставляется init, он используется для инициализации
строка ввода. При вводе строки возврат на одну позицию, удалять и клавиши курсора могут
использоваться для исправления опечаток. Если входная строка длиннее, чем может поместиться
диалоговое окно, поле ввода будет прокручиваться.

При выходе строка ввода будет напечатана на Диалогвывод.

--inputmenu текст высота ширина высота меню [ день пункт ] ...
An меню ввода коробка очень похожа на обычную МЕНЮ коробка. Есть всего несколько
различия между ними:

1. Записи не центрируются автоматически, а корректируются по левому краю.

2. Дополнительная кнопка (называется Переименовывать) подразумевается для переименования текущего элемента, когда он
нажата.

3. Можно переименовать текущую запись, нажав кнопку Переименовывать кнопка. потом
Диалог напишу следующее на Диалогвывод.

ПЕРЕИМЕНОВАН

--меню текст высота ширина высота меню [ день пункт ] ...
Как следует из названия, МЕНЮ box - это диалоговое окно, которое можно использовать для представления списка
вариантов выбора в виде меню для выбора пользователем. Варианты отображаются в
отданный приказ. Каждый пункт меню состоит из день строка и пункт нить. В
день дает записи имя, чтобы отличить ее от других записей в меню.
Ассоциация пункт - краткое описание опции, которую представляет запись. Пользователь
можно перемещаться между пунктами меню, нажимая клавиши курсора, первая буква
домен день как горячая клавиша или цифровые клавиши 1 через 9, Есть высота меню
записи, отображаемые в меню одновременно, но меню будет прокручиваться, если есть
больше записей, чем это.

При выходе день выбранного пункта меню будет напечатан на Диалогвывод. Если
"- кнопка помощи", соответствующий текст справки будет напечатан, если
пользователь нажимает кнопку справки.

- смешанная форма текст высота ширина высота формы [ этикетка y x пункт y x флен Илен Я печатаю ] ...
Ассоциация смешанная форма диалоговое окно отображает форму, состоящую из меток и полей, очень похожую на
--форма диалог. Он отличается добавлением параметра типа поля к каждому полю
описание. Каждый бит в типе обозначает атрибут поля:

1 скрыто, например, поле пароля.

2 только для чтения, например, этикетка.

- смешанный калибр текст высота ширина процент [ tag1 item1 ] ...
A смешанный В нижней части окна отображается метр. Счетчик показывает
процент.

Он также отображает список день- а также пункт-значения вверху поля. Видеть
Диалог(3) для значений тегов.

Ассоциация текст отображается как заголовок между списком и счетчиком. В процент ценностное
обозначает начальный процент, отображаемый в глюкометре.

Не предусмотрено считывание данных со стандартного ввода как --измерять делает.

При выходе текст не записывается Диалогвывод. Виджет не принимает никаких данных, поэтому
статус выхода всегда в порядке.

--msgbox текст высота ширина
A сообщение коробка очень похожа на да нет коробка. Единственная разница между
сообщение коробка и да нет коробка это что сообщение коробка имеет только один OK .
Вы можете использовать это диалоговое окно для отображения любого сообщения, которое вам нравится. После прочтения
сообщение, пользователь может нажать ENTER ключ так, чтобы Диалог выйдет и вызов
сценарий оболочки может продолжить свою работу.

Если сообщение слишком велико для этого места, Диалог может позволить вам прокрутить его,
при условии, что базовая реализация curses достаточно способна. В этом
В этом случае процентное соотношение отображается в основании виджета.

При выходе текст не записывается Диалогвывод. Предусмотрена только кнопка «ОК».
для ввода, но может быть возвращен статус выхода ESC.

--Пауза текст высота ширина секунды
A Пауза В нижней части окна отображается метр. Измеритель показывает, как
до конца паузы остается много секунд. Пауза завершается по истечении тайм-аута.
достигнута, или пользователь нажимает кнопку ОК (статус ОК), или пользователь нажимает кнопку
Кнопка ОТМЕНА или клавиша Esc.

--passwordbox текст высота ширина [в этом]
A password поле похоже на поле ввода, за исключением того, что вводимый пользователем текст
не отображается. Это полезно при запросе паролей или других конфиденциальных
Информация. Имейте в виду, что если что-то передано в "init", это будет видно в
таблица процессов системы для случайных наблюдателей. Кроме того, это очень сбивает с толку
пользователь, чтобы предоставить им пароль по умолчанию, который они не могут видеть. По этим причинам,
использование "init" крайне не рекомендуется. Видеть "--ненадежный"если вы не заботитесь о своем
пароль.

При выходе строка ввода будет напечатана на Диалогвывод.

- форма пароля текст высота ширина высота формы [ этикетка y x пункт y x флен Илен ] ...
Это идентично --форма за исключением того, что все текстовые поля обрабатываются как password
виджеты, а не поле ввода виджеты.

--prgbox текст команду высота ширина

--prgbox команду высота ширина
A пргбокс очень похож на программа.

Это диалоговое окно используется для отображения вывода команды, указанной как
аргумент пргбокс.

После завершения команды пользователь может нажать кнопку ENTER ключ так, чтобы Диалог будете
exit и вызывающий сценарий оболочки может продолжить свою работу.

Если задано три параметра, он отображает текст под заголовком, выделенный
из содержимого прокручиваемого файла. Если даны только два параметра, этот текст
опущено.

--программбокс текст высота ширина

--программбокс высота ширина
A программа очень похож на прогрессбокс. Единственная разница между
программа коробка и прогресс коробка это что программа поле отображает OK кнопка (но
только после завершения команды).

Это диалоговое окно используется для отображения вывода команды по конвейеру. После
команда завершена, пользователь может нажать кнопку ENTER ключ так, чтобы Диалог выйдет и
вызывающий сценарий оболочки может продолжить свою работу.

Если задано три параметра, он отображает текст под заголовком, выделенный
из содержимого прокручиваемого файла. Если даны только два параметра, этот текст
опущено.

--прогрессбокс текст высота ширина

--прогрессбокс высота ширина
A прогрессбокс похож на хвостовой ящик, Кроме этого

а) вместо отображения содержимого файла,
он отображает вывод команды по конвейеру и

б) он выйдет, когда достигнет конца файла
(кнопки «ОК» нет).

Если задано три параметра, он отображает текст под заголовком, выделенный
из содержимого прокручиваемого файла. Если даны только два параметра, этот текст
опущено.

--радиолист текст высота ширина высота списка [ день пункт статус ] ...
A радиолист коробка похожа на МЕНЮ коробка. Единственная разница в том, что вы можете
указать, какая запись выбрана в данный момент, установив ее статус в on.

При выходе тег выбранного элемента записывается в Диалогвывод.

- хвостовая коробка файл высота ширина
Отображение текста из файла в диалоговом окне, как в команде "tail -f". Прокрутка
влево / вправо с помощью vi-стиля 'h' и 'l' или клавиш со стрелками. «0» сбрасывает прокрутку.

При выходе текст не записывается Диалогвывод. Предусмотрена только кнопка «ОК».
для ввода, но может быть возвращен статус выхода ESC.

--rangebox текст высота ширина минимальное значение максимальное значение значение по умолчанию
Разрешить пользователю выбирать из диапазона значений, например, с помощью ползунка. Диалог
показывает текущее значение в виде полосы (как в диалоговом окне датчика). Вкладки или клавиши со стрелками перемещаются
курсор между кнопками и значением. Когда курсор находится на значении, вы
можно редактировать:

перемещение курсора влево / вправо для выбора цифры для изменения

+/- символы для увеличения / уменьшения цифры на единицу

0 через 9
установить цифру на заданное значение

Некоторые клавиши также распознаются во всех положениях курсора:

домой / конец
установить максимальное или минимальное значение

pageup / pagedown
увеличивать значение так, чтобы ползунок перемещался на один столбец

--tailboxbg файл высота ширина
Отображение текста из файла в диалоговом окне в качестве фоновой задачи, как в "tail -f &"
команда. Прокрутите влево / вправо, используя буквы «h» и «l» в стиле vi или клавиши со стрелками. А '0'
сбрасывает прокрутку.

Dialog обрабатывает фоновую задачу особенно, если есть другие виджеты (--и-
виджет) на экране одновременно. Пока эти виджеты не будут закрыты (например,
"В ПОРЯДКЕ"), Диалог выполнит все виджеты tailboxbg в одном процессе,
опрос обновлений. Вы можете использовать вкладку для перехода между виджетами на
экрана, и закройте их по отдельности, например, нажав ENTER. Когда-то не-
виджеты tailboxbg закрыты, Диалог копирует себя на задний план,
и печатает свой идентификатор процесса, если "--без убийствпредоставляется вариант.

При выходе текст не записывается Диалогвывод. Предусмотрена только кнопка «ВЫХОД».
для ввода, но может быть возвращен статус выхода ESC.

ПРИМЕЧАНИЕ. Более старые версии Диалог сразу разветвился и попытался обновить
экран индивидуально. Помимо того, что это плохо для производительности, это было неработоспособно. Немного
старые сценарии могут некорректно работать со схемой опроса.

--текстовое окно файл высота ширина
A текст позволяет отображать содержимое текстового файла в диалоговом окне. это
как простой просмотрщик текстовых файлов. Пользователь может перемещаться по файлу, используя
курсор, страница вверх, страница вниз и ГЛАВНАЯ / КОНЕЦ клавиши доступны на большинстве клавиатур. Если
строки слишком длинные для отображения в поле, ЛЕВО ПРАВО ключи могут быть использованы для
прокрутите текстовую область по горизонтали. Вы также можете использовать клавиши h, j, k и l в стиле vi.
вместо клавиш курсора и B или N вместо клавиш перехода на страницу вверх и вниз.
Прокрутите вверх / вниз, используя клавиши «k» и «j» в стиле vi или клавиши со стрелками. Прокрутите влево / вправо с помощью
vi-стиль 'h' и 'l' или клавиши со стрелками. «0» сбрасывает прокрутку влево / вправо. За
больше удобства, функции прямого и обратного поиска в стиле vi также
при условии.

При выходе текст не записывается Диалогвывод. Предусмотрена только кнопка «ВЫХОД».
для ввода, но может быть возвращен статус выхода ESC.

--таймбокс текст высота [ширина час минут второй]
Отображается диалоговое окно, в котором можно выбрать час, минуту и ​​секунду. Если
значения часа, минуты или секунды отсутствуют или отрицательны, текущая дата
используются соответствующие значения. Вы можете увеличивать или уменьшать любой из них, используя
стрелки влево, вверх, вправо и вниз. Используйте вкладку или обратную вкладку для перехода между
окна.

При выходе результат печатается в формате час: минута: секунда. Формат может быть
переопределено с помощью - формат времени опцию.

--в виде дерева текст высота ширина высота списка [ день пункт статус глубина ] ...
Отображение данных в виде дерева. Каждая группа данных содержит тег, текст для
отображение элемента, его статус («включен» или «выключен») и глубину элемента в
дерево.

Можно выбрать только один элемент (например, радиолист). Тег не отображается.

При выходе тег выбранного элемента записывается в Диалогвывод.

--да нет текст высота ширина
A да нет диалоговое окно размера высота ряды по ширина будут отображаться столбцы. В
строка, указанная текст отображается внутри диалогового окна. Если эта строка слишком
длинный, чтобы поместиться в одну строку, он будет автоматически разделен на несколько строк в
подходящие места. В текст строка также может содержать подстроку "\n" или же
символы новой строки `\n'для явного управления разрывом строки. Это диалоговое окно
полезно для того, чтобы задавать вопросы, требующие от пользователя ответа «да» или «нет». В
диалоговое окно имеет Да кнопка и Нет кнопка, с помощью которой пользователь может переключаться между
нажав TAB .

При выходе текст не записывается Диалогвывод. Помимо «Да» и «Нет»
коды выхода (см. ДИАГНОСТИКА) может быть возвращен статус выхода ESC.

Коды, используемые для «Да» и «Нет», совпадают с кодами, используемыми для «ОК» и «Отмена»,
внутри не делается никаких различий.

Устаревший Опции
- писк Это использовалось, чтобы сообщить оригинальному cdialog, что он должен издавать звуковой сигнал, когда
отдельные процессы виджета tailboxbg перерисовали бы экран.

- бип-после
Звуковой сигнал после того, как пользователь завершил работу над виджетом, нажав одну из кнопок.

ВРЕМЯ РАБОТЫ КОНФИГУРАЦИЯ

1. Создайте образец файла конфигурации, набрав:

диалог --create-rc файл

2. В начале Диалог определяет используемые настройки следующим образом:

а) если переменная окружения ДИАЛОГРК установлен, его значение определяет имя
Файл конфигурации.

б) если файл в (а) не найден, используйте файл $ HOME / .dialogrc как конфигурация
.

c) если файл в (b) не найден, попробуйте использовать файл GLOBALRC, определенный в
время компиляции, т. е. / и т.д. / dialogrc.

d) если файл в (c) не найден, используйте скомпилированные по умолчанию.

3. Отредактируйте образец файла конфигурации и скопируйте его в какое-нибудь место, Диалог можно найти, как
указано в шаге 2 выше.

KEY ПРИЛОЖЕНИЯ

Вы можете переопределить или добавить привязки клавиш в Диалог добавив в файл конфигурации.
Диалог's привязка команда сопоставляет отдельные ключи своей внутренней кодировке.

привязка виджет проклятия_ключ диалог_клавиша

Ассоциация виджет имя может быть "*" (все виджеты) или определенные виджеты, такие как текстовое поле, Конкретный
Привязки виджетов имеют приоритет над привязками "*". Пользовательские привязки отменяют встроенные
привязки.

Ассоциация проклятия_ключ может быть любым из имен, производных от проклятия.h, например, "ПОМОЩЬ" из
«KEY_HELP». Диалог также распознает управляющие символы ANSI, такие как «^ A», «^?», а также
C1-элементы управления, такие как «~ A» и «~?». Наконец, он позволяет экранировать любой одиночный символ.
с обратной косой чертой.

Диалогимена внутренних кодов клавиш соответствуют DLG_KEYS_ENUM печатать dlg_keys.hнапример,
«ПОМОЩЬ» от «DLGK_HELP».

Виджет имен
У некоторых виджетов (например, formbox) есть область, где можно редактировать поля. Это
управляется в подокне виджета и может иметь отдельные сочетания клавиш от основного
виджет, потому что подокна зарегистрированы под другим именем.

Виджет Окно имя Подокно Фамилия
──────────────────────────────────────────────
календарь календарь
контрольный список контрольный список
поле редактирования поле редактирования поле редактирования 2

форма formbox formfield
fвыбрать fвыбрать fвыбрать2
поле ввода поле ввода поле ввода2
меню меню
сообщение
пауза пауза
прогрессбокс прогрессбокс
радиолист радиолист
задний ящик задний ящик
текстовое поле текстовое поле поисковое поле
таймбокс таймбокс
да нет да нет
──────────────────────────────────────────────

Некоторые виджеты на самом деле являются другими виджетами, для изменения поведения которых используются внутренние настройки.
Они используют то же имя виджета, что и сам виджет:

Виджет Представить Виджет
───────────────────────────────
двыбрать фвыбрать
информационное окно msgbox
меню ввода
смешанная форма
поле ввода пароля
форма пароля
prgbox
Programbox ProgressBox
задний ящик
───────────────────────────────

Встроенный Наручники
На этой странице руководства не перечислены привязки клавиш для каждого виджета, потому что это подробно описано
информацию можно получить, запустив Диалог. Если вы установили --след вариант, Диалог
записывает информацию о привязке клавиш для каждого виджета по мере его регистрации.

Пример
Обычная стоимость Диалог использует разные клавиши для перехода между кнопками и редактирования части
диалог по сравнению с перемещением внутри редактируемой части. То есть переход по табуляции (и обратной табуляции)
кнопок (или между кнопками и частью редактирования), а клавиши со стрелками перемещаются по полям внутри
редакционная часть. Вкладки также считаются особым случаем перехода между
виджеты, например, при использовании нескольких виджетов tailboxbg.

Некоторые пользователи могут захотеть использовать тот же ключ для перемещения внутри редактируемой части, что и для
переход между кнопками. Виджет формы написан для поддержки такого рода
переопределение ключей путем добавления специальной группы в dlgk_keys.h для "формы"
(влево / вправо / далее / назад). Вот пример привязки, демонстрирующий, как это сделать:

поле формы bindkey TAB form_NEXT
окно формы связывания TAB form_NEXT
поле формы bindkey BTAB form_prev
окно формы связывания BTAB form_prev

Такое переопределение не будет полезно в других виджетах, например, в календаре, из-за
потенциально большое количество полей для обхода.

ОКРУЖАЮЩАЯ СРЕДА

ДИАЛОГОПТЫ Определите эту переменную, чтобы применить любые общие параметры к каждому виджету.
Большинство общих параметров сбрасываются перед обработкой каждого виджета. если ты
установите параметры в этой переменной среды, они применяются к Диалог's
состояние после сброса. Как в "--файл"вариант, двойные кавычки и
обратная косая черта интерпретируется.

"--файл"вариант не считается распространенным вариантом (поэтому вы не можете встроить
это в этой переменной среды).

ДИАЛОГРК Определите эту переменную, если вы хотите указать имя конфигурации
файл для использования.

DIALOG_CANCEL

ДИАЛОГ_ОШИБКА

ДИАЛОГ_ESC

DIALOG_EXTRA

DIALOG_HELP

DIALOG_ITEM_HELP

ДИАЛОГ_ОК Определите любую из этих переменных, чтобы изменить код выхода на Cancel (1), error
(-1), ESC (255), Дополнительно (3), Справка (2), Помощь с --item-помощь (2) или ОК (0).
Обычно сценарии оболочки не могут различать -1 и 255.

DIALOG_TTY Установите для этой переменной значение «1», чтобы обеспечить совместимость со старыми версиями
Диалог предполагалось, что если сценарий перенаправляет стандартный вывод, то
"--stdout"вариант был дан.

Использование диалогового окна онлайн с помощью сервисов onworks.net