діалогове вікно - Онлайн у хмарі

ПРОГРАМА:

ІМ'Я

dialog - відображення діалогових вікон із сценаріїв оболонки

СИНТАКСИС

Діалог -- ясно
Діалог --create-rc файл
Діалог --print-maxsize
Діалог загальні варіанти коробки-опції

ОПИС

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

список збірки, календар, Контрольний список, dselect, поле редагування, форма, fselect, калібр, інфобокс,
поле введення, меню введення, меню, змішана форма, змішаний калібр, msgbox (повідомлення), пароль,
форма пароля, пауза, prgbox, програмне поле, вікно прогресу, радіолист, діапазон, хвостова коробка,
tailboxbg, текстове вікно, таймбокс, treeview та так ні (так ні).

У сценарій можна розмістити більше одного діалогового вікна:

· Використовувати "--і-віджет«знак сили Діалог щоб перейти до наступного діалогового вікна, якщо ви не
натиснули ESC, щоб скасувати, або

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

Деякі віджети, наприклад, контрольний список, будуть записувати текст Діалог's вихід. Зазвичай це те
стандартна помилка, але є варіанти змінити це: "--output-fd""--stderr"і
"--stdout". При натисканні кнопки Скасування (або ESC) текст не записується; Діалог виходи
негайно в такому випадку.

ВАРІАНТИ

Усі варіанти починаються з "--" (два дефіса ASCII, на користь тих, хто використовує системи
з невірною підтримкою локалі).

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

"--args" розповідає варіант Діалог щоб відобразити стандартні параметри командного рядка
помилка. Це корисно під час налагодження складних сценаріїв за допомогою "--"І"--файл", оскільки
командний рядок може бути переписаний у міру їх розширення.

"--файл" розповідає варіант Діалог щоб прочитати параметри з файлу, названого як його значення.
Діалог --файл файл параметрів
Пропуски, які не входять у подвійні лапки, відкидаються (використовуйте зворотні косі риски, щоб уводити одинарні лапки
символи). Результат вставляється в командний рядок, замінюючи "--файл"і його
вартість опціону. Інтерпретація командного рядка відновиться з цього моменту. Якщо
файл параметрів починається з "&", Діалог інтерпретує наступний текст як дескриптор файлу
номер, а не ім'я файлу.

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

--ascii-рядки
Замість того, щоб малювати графічні лінії навколо квадратів, намалюйте ASCII «+» і «-» у тому самому
місце. Дивіться також "--без рядків".

--аспект співвідношення
Це дає вам деякий контроль над розмірами коробки під час використання автоматичного розміру
(указуючи 0 для висоти та ширини). Він представляє ширину / висоту. За замовчуванням є
9, що означає 9 символів у ширину на кожен 1 рядок у висоту.

--заголовок зворотний заголовок
Вказує a зворотний заголовок рядок, який відображатиметься на тлі, у верхній частині
екран.

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

--скасувати-мітка рядок
Замінити мітку, яка використовується для кнопок «Скасувати».

-- ясно
Очищає екран віджета, зберігаючи лише фон екрану. Використовуйте це, коли
ви комбінуєте віджети з "--і-віджет", щоб стерти вміст попереднього віджета
на екрані, тому він не відображатиметься під вмістом наступного віджета.
Зрозумійте це як доповнення до "--keep-window". Щоб порівняти ефекти, використовуйте
ці:

Виджети всі три віджети, ефект сходів, упорядковано 1,2,3:

діалогове вікно \
--початок 2 2 --yesno "" 0 0 \
--and-widget --begin 4 4 --yesno "" 0 0 \
--і-віджет --початок 6 6 --yesno "" 0 0

Лише останній віджет залишається видимим:

діалогове вікно \
--clear --begin 2 2 --yesno "" 0 0 \
--and-widget --clear --begin 4 4 --yesno "" 0 0 \
--і-віджет --початок 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 \
--і-віджет --початок 6 6 --yesno "" 0 0

Виджет перший і третій віджети, ефект сходів, упорядковано 3,1:

діалогове вікно \
--keep-window --begin 2 2 --yesno "" 0 0 \
--and-widget --clear --begin 4 4 --yesno "" 0 0 \
--і-віджет --початок 6 6 --yesno "" 0 0

Зверніть увагу, якщо ви хочете відновити оригінальні кольори консолі та відправити курсор додому
після закриття діалогової програми скористайтеся ясно (1) команда.

--кольори
Інтерпретувати вбудовані послідовності "\Z" у текст діалогу за таким символом:
що розповідає Діалог щоб встановити кольори або атрибути відео:

· Від 0 до 7 – це номери кольорів ANSI, які використовуються в прокляттях: чорний, червоний, зелений,
жовтий, синій, пурпурний, блакитний і білий відповідно.

· Жирний шрифт встановлюється 'b', скидається 'B'.

· Реверс встановлюється 'r', скидання 'R'.

· Підкреслення встановлюється 'u', скидається 'U'.

· Налаштування є сукупними, наприклад, "\Zb\Z1" робить наступний текст жирним
(можливо, яскраво) червоний.

· Відновіть нормальні налаштування за допомогою «\Zn».

--роздільник стовпців рядок
Сказати Діалог щоб розділити дані для радіо/прапорців і меню щодо випадків
заданий рядок і вирівняти розділені дані за стовпцями.

--cr-wrap
Інтерпретувати вбудований новий рядок у текст діалогу як новий рядок на екрані.
Інакше Діалог переносить рядки лише там, де це необхідно для розміщення всередині текстового поля.

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

Дивіться також "--без колапсу"І"-- обрізати"варіанти.

--create-rc файл
Коли Діалог підтримує конфігурацію часу виконання, це можна використовувати для дампу зразка
конфігураційного файлу до файлу, зазначеного в файл.

--формат дати формат
Якщо господар надає strftime, цей параметр дозволяє вказати формат файлу
надрукована дата для --календар віджет. Час доби (година, хвилина, секунда).
поточний місцевий час.

--за замовчуванням
Зробіть значення за замовчуванням так ні коробка а Немає. Так само зробіть кнопку за замовчуванням
віджетів, які забезпечують "ОК" і "Скасувати" a Скасувати. якщо "--не скасувати"Або"--відвідати-
пунктів", ці параметри замінюють це, роблячи кнопку за замовчуванням завжди
«Так» (внутрішньо те саме, що «ОК»).

--кнопка за замовчуванням рядок
Встановити кнопку за замовчуванням (попередньо вибрану) у віджеті. Попередньо вибравши кнопку, a
скрипт дає можливість користувачеві просто натиснути Що натомість? Створіть віртуальну версію себе у пройти через а
діалог з мінімальною взаємодією.

Значенням параметра є назва кнопки: ok, так, відмінити, немає, допомога or додатково.

Зазвичай перша кнопка в кожному віджеті є за замовчуванням. Перша показана кнопка
визначається віджетом разом із "--куточок"І"--не скасувати варіанти. Якщо
ця опція не вказана, кнопка за замовчуванням не призначена.

--елемент за замовчуванням рядок
Установіть елемент за замовчуванням у контрольному списку, формі або вікні меню. Зазвичай перший елемент в
поле за замовчуванням.

--exit-label рядок
Замінити мітку, яка використовується для кнопок "ВИХІД".

--додаткова кнопка
Показати додаткову кнопку між кнопками «ОК» і «Скасувати».

--додаткова етикетка рядок
Замінити мітку, яка використовується для кнопок «Додатково». Примітка: для віджетів меню введення це
за замовчуванням «Перейменувати».

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

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

Після виходу статус повернення буде вказувати, що була натиснута кнопка Довідка. Діалог
також запише повідомлення на свій вихід після маркера "ДОПОМОГА":

· Якщо "--пункт-довідка" також надається, буде написаний текст довідки по елементу.

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

Ви можете використовувати --довідкові теги опцію та/або встановити середовище DIALOG_ITEM_HELP
змінної, щоб змінити ці повідомлення та статус виходу.

--мітка довідки рядок
Замінити мітку, яка використовується для кнопок «Довідка».

--довідка-статус
Якщо кнопку довідки вибрано, записує контрольний список, радіолист або інформацію форми
після пункту-довідки інформації «ДОПОМОГА». Це можна використати для реконструкції держави
контрольного списку після обробки запиту на допомогу.

--довідкові теги
Змініть повідомлення, написані під час виходу для --кнопка довідки роблячи їх завжди справедливими
тег предмета. Це не впливає на код статусу виходу.

--hfile ім'я файлу
Відображати даний файл за допомогою текстового поля, коли користувач натискає F1.

--hline рядок
Відобразити вказаний рядок по центру внизу віджета.

--ігнорувати
Ігноруйте такі варіанти Діалог не визнає. Деякі відомі, такі як
"--значок" все одно ігноруються, але це кращий вибір для сумісності з
інші реалізації.

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

--небезпечно
Робить віджет пароля зручнішим, але менш безпечним, повторюючи зірочки для кожного
характер.

--iso-тиждень
Встановіть початкову точку для номера тижня, показаного в "--календар"варіант
відповідно до ISO-8601, нумерація якого починається з першого тижня, що включає а
Четвер січня.

--пункт-довідка
Інтерпретуйте дані тегів для контрольного списку, радіосписку та полів меню, додаючи стовпець
яка відображається в нижньому рядку екрана для поточного вибраного
пункт.

--keep-tite
При будівництві с ncurses, Діалог зазвичай перевіряє, чи працює він у файлі
xterm, і в цьому випадку намагається придушити рядки ініціалізації, які б
переключіть його на альтернативний екран. Перемикання між звичайним і альтернативним
екрани візуально відволікають у сценарії, який запускається Діалог декілька разів. Використовуйте
цей параметр дозволити Діалог використовувати ці рядки ініціалізації.

--keep-window
Зазвичай, коли Діалог виконує кілька tailboxbg віджети, з'єднані "--і-
віджет", він очищає старий віджет з екрана, зафарбовуючи його. Використовуйте це
можливість придушити це перефарбування.

на виході, Діалог перефарбовує всі віджети, позначені "--тримати-
вікно", навіть якщо вони не є tailboxbg віджети. Це змушує їх перефарбовувати
у зворотному порядку. Дивіться обговорення "-- ясно" варіант для прикладів.

-- останній ключ
При виході повідомте про останній ключ, який ввів користувач. Це код ключа curses
а не символ або буквальний символ. Його можна використовувати сценаріями для
розрізняти два ключі, які прив’язані до однієї дії.

--max-вхід розмір
Обмежте вхідні рядки заданим розміром. Якщо не вказано, ліміт становить 2048.

--не-скасувати

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

--без колапсу
Зазвичай Діалог перетворює табуляції на пробіли та зменшує декілька пробілів до одного
простір для тексту, який відображається у вікнах повідомлень тощо. Використовуйте цей параметр, щоб
вимкнути цю функцію. Зауважте, що Діалог все одно буде переносити текст з урахуванням "--cr-
обернути"І"-- обрізати"варіанти.

-- немає предметів
Деякі віджети (контрольний список, меню введення, радіолист, меню) відображають список з двома
стовпці ("тег" і "елемент", тобто "опис"). Цей варіант розповідає Діалог до
читайте коротші рядки, пропускаючи частину списку «пункт». Це час від часу
корисно, наприклад, якщо теги надають достатньо інформації.

Дивіться також --без тегів. Якщо вказані обидва варіанти, цей ігнорується.

--не вбивати
Розповідає Діалог поставити tailboxbg поле у ​​фоновому режимі, друкуючи його ідентифікатор процесу
Діалог's вихід. SIGHUP вимкнено для фонового процесу.

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

--без рядків
Замість того, щоб малювати лінії навколо квадратів, намалюйте пробіли в тому ж місці. Дивіться також
"--ascii-рядки".

--без миші
Не вмикайте мишу.

--no-nl-expand
Не перетворюйте підрядки "\n" тексту повідомлення/підказки в буквальний новий рядок.

--ні-добре

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

--без тіні
Придушити тіні, які будуть намальовані праворуч і внизу кожного діалогового вікна.

--без тегів
Деякі віджети (контрольний список, меню введення, радіолист, меню) відображають список з двома
стовпці ("тег" і "опис"). Тег корисний для написання сценаріїв, але не може
допомогти користувачеві. The --без тегів параметр (з Xdialog) може використовуватися для придушення
стовпець тегів з дисплея. На відміну від -- немає предметів варіант, цього немає
впливати на дані, які зчитуються зі скрипту.

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

Зазвичай Діалог дозволяє швидко переходити до записів у відображеному списку за допомогою
відповідність одного символу першому символу тегу. Коли --без тегів
надається варіант, Діалог збігається з першим символом опису. в
У будь-якому випадку відповідний символ буде виділено.

--ok-етикетка рядок
Замінити мітку, яка використовується для кнопок «ОК».

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

--роздільник рядок

-- вихід-роздільникрядок
Вкажіть рядок, який буде розділяти вихід Діалогвихід із контрольних списків,
а не новий рядок (для --окремий вихід) або пробіл. Це стосується інших
віджети, такі як форми та поля редагування, які зазвичай використовують новий рядок.

--print-maxsize
Надрукуйте максимальний розмір діалогових вікон, тобто розмір екрана Діалог's вихід.
Це можна використовувати окремо, без інших опцій.

--розмір друку
Друкує розмір кожного діалогового вікна Діалог's вихід.

-- Версія для друку
Роздруківки ДіалогВерсія для Діалог's вихід. Це можна використовувати окремо, без інших
варіанти. Це не викликає Діалог вийти самостійно.

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

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

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

--окремий віджет рядок
Вкажіть рядок, який буде розділяти вихід Діалог' з кожного віджета.
Це використовується для спрощення аналізу результату діалогу з кількома віджетами. Якщо
ця опція не вказана, рядок роздільника за замовчуванням є символом табуляції.

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

-- в одинарних лапках
Використовуйте одинарні лапки за потреби (і без лапок, якщо вони не потрібні) для виведення
контрольний список, а також текст довідки. Якщо цей параметр не встановлено, Діалог використовує
подвійні лапки навколо кожного пункту. В будь-якому випадку, Діалог додає зворотні косі риси, щоб зробити
вихід корисний у сценаріях оболонки.

--size-err
Перевірте отриманий розмір діалогового вікна, перш ніж спробувати його використовувати, надрукувавши файл
отриманий розмір, якщо він більший за екран. (Цей варіант застарів, оскільки
всі виклики нового вікна перевіряються).

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

--stderr
Прямий вихід до стандартної помилки. Це значення за замовчуванням, оскільки лайка зазвичай
записує оновлення екрана до стандартного виводу.

--stdout
Прямий вихід на стандартний вихід. Ця опція передбачена для сумісності
з Xdialog, однак використовувати його в переносимих сценаріях не рекомендується, оскільки прокляття
зазвичай записує оновлення екрана до стандартного виводу. Якщо ви використовуєте цю опцію,
Діалог намагається знову відкрити термінал, щоб він міг записувати на дисплей. Залежно
на платформі та вашому середовищі, це може вийти з ладу.

-- табуляція правильно
Перетворіть кожен символ табуляції в один або кілька пробілів (для текстове вікно віджет; інакше
до одного простору). В іншому випадку вкладки відображаються відповідно до бібліотеки curses
інтерпретація.

--таб-лен n
Вкажіть кількість пробілів, які займає символ табуляції, якщо "-- табуляція правильно"
надається варіант. За замовчуванням – 8. Цей параметр діє лише для текстове вікно
віджет

-- формат часу формат
Якщо господар надає strftime, цей параметр дозволяє вказати формат файлу
час, надрукований для --часове вікно віджет. У цьому випадку значення дня, місяця, року
за поточним місцевим часом.

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

Цей параметр ігнорується "--пауза" віджет. Він також замінюється, якщо
фон "--tailboxbgОпція " використовується для налаштування кількох одночасних віджетів.

-- назва назву
Вказує a назву рядок, який відображатиметься у верхній частині діалогового вікна.

--слід ім'я файлу
реєструє параметри командного рядка, натискання клавіш та іншу інформацію до заданої
файл. Якщо Діалог читає файл конфігурації, він також реєструється. Трубопровідний вхід до
калібр віджет зареєстровано. Використовуйте control/T, щоб зареєструвати зображення поточного діалогового вікна
вікна.

--початок тижня день
встановлює день початку тижня, який використовується в "--календар" варіант день
параметр може бути

· число (від 0 до 6, з неділі по суботу за допомогою POSIX) або

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

· рядок, що відповідає одній із скорочень для дня тижня, показаних у
календар віджет, наприклад, "Пн" для "понеділка".

Команда Діалог програма спеціально обробляє деякі параметри командного рядка і видаляє їх з
список параметрів у міру їх обробки. Наприклад, якщо є перший варіант --слід,
потім це обробляється (і видаляється) раніше Діалог ініціалізує дисплей.

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

Дивіться також "--cr-wrap"І"--без колапсу"варіанти.

-- версія
Роздруківки ДіалогВерсія 's для стандартного виводу і виходить. Дивіться також "--друк-
версія".

--пункти для відвідування
Змініть обхід вкладок контрольного списку, радіосписку, вікна меню та меню введення, щоб включити
список предметів як один із станів. Це корисно як наочний посібник, тобто
положення курсору допомагає деяким користувачам.

Якщо вказано цю опцію, курсор спочатку поміщається в список.
До елементів списку застосовуються скорочення (перша літера тега). Якщо ви вкладете до
рядок кнопок, до кнопок застосовуються скорочення.

--так-мітка рядок
Замінити мітку, яка використовується для кнопок «Так».

Box Опції
Усі діалогові вікна мають принаймні три параметри:

текст підпис або вміст коробки.

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

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

Інші параметри залежать від типу коробки.

--buildlist текст висота ширина висота списку [ тег пункт статус ] ...
A список збірки діалогове вікно відображає два списки, розташовані поруч. Показується список ліворуч
невибрані елементи. У списку праворуч відображаються вибрані елементи. Як є предмети
якщо вибрано чи не вибрано, вони переміщуються між списками.

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

Початковий стан увімкнення/вимкнення кожного запису визначається за допомогою статус.

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

· Якщо --пункти для відвідування не вказано, обхід вкладками використовує два стани (OK/Cancel).

· Якщо --пункти для відвідування задано, обхід вкладками використовує чотири стани
(Вліво/Вправо/ОК/Скасувати).

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

При виході список тег рядки тих записів, які увімкнені, будуть
надруковано на Діалог's вихід.

Якщо "--окремий вихід" не вказано, рядки будуть в лапках
необхідно, щоб скрипти могли легко розділити їх. За замовчуванням використовується
подвійні лапки. Дивіться "-- в одинарних лапках", який змінює цитування
поведінка.

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

При виході дата друкується у формі день/місяць/рік. Формат може бути
перевизначено за допомогою --формат дати варіант.

-- контрольний список текст висота ширина висота списку [ тег пункт статус ] ...
A Контрольний список коробка схожа на a меню коробка; представлено кілька записів
форму меню. Інша відмінність полягає в тому, що ви можете вказати, який запис
на даний момент вибрано, встановивши його статус до on. Замість того, щоб вибрати один запис
серед записів кожен запис може бути включено або вимкнено користувачем. Початковий
стан увімкнення/вимкнення кожного запису визначається за допомогою статус.

При виході список тег рядки тих записів, які увімкнені, будуть
надруковано на Діалог's вихід.

Якщо "--окремий вихід" не вказано, рядки будуть в лапках
необхідно, щоб скрипти могли легко розділити їх. За замовчуванням використовується
подвійні лапки. Дивіться "-- в одинарних лапках", який змінює цитування
поведінка.

--dselect шлях до файлу висота ширина
У діалоговому вікні вибору каталогу відображається вікно введення тексту, у якому можна ввести a
каталог, а над ним вікно з іменами каталогів.

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

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

Введення будь-яких друкованих символів перемикає фокус на вікно введення тексту, введення
цього символу, а також прокручування вікна каталогу до найближчого відповідності.

Використовуйте повернення каретки або кнопку «ОК», щоб прийняти поточне значення в тексті-
вікно входу та виходу.

Після виходу вміст вікна введення тексту записується Діалог's вихід.

--редагування шлях до файлу висота ширина
У діалоговому вікні редагування відображається копія файлу. Ви можете редагувати його за допомогою
повернення на одну позицію, видаляти і клавіші керування курсором для виправлення помилок друку. Це також визнає
pageup/pagedown. На відміну від --поле введення, потрібно вкладкою до "ОК" або "Скасувати"
кнопки, щоб закрити діалогове вікно. Натискання клавіші «Enter» всередині поля розділить
відповідний рядок.

Після виходу вміст вікна редагування записується до Діалог's вихід.

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

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

· Якщо флен є від’ємним, відповідне поле не може бути змінено, а значення заперечується
Значення флен використовується як відображена довжина.

· Якщо ілен дорівнює нулю, він встановлений на флен.

Використовуйте стрілки вгору/вниз (або control/N, control/P) для переміщення між полями. Використовуйте вкладку, щоб
переміщатися між вікнами.

При виході вміст полів форми записується Діалог's вихід, кожне поле
розділені новим рядком. Текст, який використовується для заповнення полів, які не можна редагувати (флен дорівнює нулю або
негативний) не виписується.

--fselect шлях до файлу висота ширина
Команда fselect діалогове вікно (вибір файлу) відображає вікно введення тексту, у якому ви можете
введіть ім'я файлу (або каталог), а над ним два вікна з іменами каталогів і
назви файлів.

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

Використовуйте клавіші табуляції або стрілки для переміщення між вікнами. У довіднику або
вікна імені файлу, використовуйте клавіші зі стрілками вгору/вниз, щоб прокрутити поточний вибір. Використовуйте
пробіл, щоб скопіювати поточний вибір у вікно введення тексту.

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

Введення сил пробілу Діалог для завершення поточної назви (до
точка, де може бути збіг з більш ніж одним записом).

Використовуйте повернення каретки або кнопку «ОК», щоб прийняти поточне значення в тексті-
вікно входу та виходу.

Після виходу вміст вікна введення тексту записується Діалог's вихід.

-- калібр текст висота ширина [відсоток]
A калібр box відображає метр уздовж нижньої частини коробки. Лічильник вказує на
відсоток. Нові відсотки зчитуються зі стандартного введення, одне ціле число на рядок.
Лічильник оновлюється, щоб відображати кожен новий відсоток. Якщо стандартний вхід читає
рядок "XXX", то перший рядок, наступний за ним, приймається як ціле число у відсотках,
потім наступні рядки до іншого "XXX" використовуються для нового підказки. Датчик
виходить, коли EOF досягається на стандартному вході.

Команда відсотків значення означає початковий відсоток, показаний у лічильнику. Якщо ні
зазначено, воно дорівнює нулю.

При виході текст не записується Діалог's вихід. Віджет не приймає введення, тому
статус виходу завжди ОК.

--інфобокс текст висота ширина
An інформація коробка в основному a повідомлення коробка. Однак у цьому випадку Діалог вийде
відразу після відображення повідомлення користувачеві. Екран не очищається
коли Діалог виходить, так що повідомлення залишатиметься на екрані до моменту дзвінка
сценарій оболонки очищає його пізніше. Це корисно, коли ви хочете повідомити про це користувача
виконуються деякі операції, для завершення яких може знадобитися деякий час.

При виході текст не записується Діалог's вихід. Повертається статус виходу OK.

--поле введення текст висота ширина [у цьому]
An вхід box корисний, коли ви хочете поставити запитання, які вимагають від користувача
введіть рядок як відповідь. Якщо вказано init, він використовується для ініціалізації
вхідний рядок. При введенні рядка, повернення на одну позицію, видаляти і клавіші курсору можуть
використовуватися для виправлення помилок друку. Якщо вхідний рядок довший, ніж може вміститися
діалоговому вікні, поле введення буде прокручуватися.

Після виходу вхідний рядок буде надрукований Діалог's вихід.

--меню введення текст висота ширина висота меню [ тег пункт ] ...
An меню введення коробка дуже схожа на звичайну меню коробка. Є лише кілька
відмінності між ними:

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

2. Додаткова кнопка (наз Rename) передбачається перейменувати поточний елемент, коли він
натискається.

3. Можна перейменувати поточний запис, натиснувши кнопку Rename кнопку. Тоді
Діалог напише наступне Діалог's вихід.

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

--меню текст висота ширина висота меню [ тег пункт ] ...
Як випливає з назви, а меню box — це діалогове вікно, яке можна використовувати для представлення списку
вибір у вигляді меню, яке користувач може вибрати. Вибір відображається в
даний наказ. Кожен пункт меню складається з a тег рядок і пункт рядок. The
тег дає запису назву, щоб відрізняти його від інших записів у меню.
Команда пункт короткий опис параметра, який представляє запис. Користувач
можна переміщатися між пунктами меню, натискаючи клавіші курсору, перша літера
тег як гаряча клавіша або цифрові клавіші 1 через 9. Існує висота меню
Записи відображаються в меню одночасно, але меню буде прокручуватися, якщо воно є
більше записів, ніж це.

При виході з тег вибраного пункту меню буде надруковано Діалог's вихід. Якщо
"--кнопка довідки" задано параметр, відповідний текст довідки буде надруковано, якщо
користувач вибирає кнопку довідки.

--змішана форма текст висота ширина висота форми [ етикетка y x пункт y x флен ілен itype ] ...
Команда змішана форма діалогове вікно відображає форму, що складається з міток і полів, подібно до
--форма діалогове вікно. Він відрізняється тим, що до кожного поля додається параметр типу поля
опис. Кожен біт у типі позначає атрибут поля:

1 прихований, наприклад, поле пароля.

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

--змішаний калібр текст висота ширина відсотків [ tag1 item1 ] ...
A змішаний калібр box відображає метр уздовж нижньої частини коробки. Лічильник показує
відсоток.

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

Команда текст відображається як підпис між списком і лічильником. The відсотків значення
позначає початковий відсоток, показаний у лічильнику.

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

При виході текст не записується Діалог's вихід. Віджет не приймає введення, тому
статус виходу завжди ОК.

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

Якщо повідомлення завелике для місця, Діалог може дозволити вам прокрутити його,
за умови, що базова реалізація curses є достатньо можливою. У цьому
у віджеті відображається відсоток.

При виході текст не записується Діалог's вихід. Надається лише кнопка «ОК».
для введення, але може бути повернуто статус виходу ESC.

--пауза текст висота ширина seconds
A пауза box відображає метр уздовж нижньої частини коробки. Лічильник показує, як
до кінця паузи залишається багато секунд. Пауза завершується, коли закінчується тайм-аут
досягнуто, або користувач натискає кнопку OK (статус OK), або користувач натискає кнопку
Кнопка СКАСУВАТИ або клавіша Esc.

--скринька для пароля текст висота ширина [у цьому]
A пароль поле подібне до поля введення, за винятком того, що текст, який вводить користувач
не відображається. Це корисно під час запиту паролів або інших конфіденційних даних
інформації. Майте на увазі, що якщо щось передано в "init", це буде видно в
таблицю процесів системи для випадкових шпигунів. Крім того, це дуже заплутано для
користувач, щоб надати їм пароль за замовчуванням, який вони не бачать. З цих причин,
використання "init" вкрай не рекомендується. Подивитися "--небезпечно«якщо тобі байдуже про своє
пароль.

Після виходу вхідний рядок буде надрукований Діалог's вихід.

--форма пароля текст висота ширина висота форми [ етикетка y x пункт y x флен ілен ] ...
Це ідентично --форма за винятком того, що всі текстові поля обробляються як пароль
віджети, а не поле введення віджети.

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

--prgbox команда висота ширина
A prgbox дуже схожий на a програмне поле.

Це діалогове вікно використовується для відображення результату команди, яка вказана як
аргумент до prgbox.

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

Якщо вказано три параметри, він відображає текст під заголовком, окреслений
із вмісту прокручуваного файлу. Якщо вказано лише два параметри, це текст
пропущено.

--programbox текст висота ширина

--programbox висота ширина
A програмне поле дуже схожий на a вікно прогресу. Єдина різниця між a
програма коробка і а прогрес коробка це а програма поле відображає ан OK кнопка (але
тільки після виконання команди).

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

Якщо вказано три параметри, він відображає текст під заголовком, окреслений
із вмісту прокручуваного файлу. Якщо вказано лише два параметри, це текст
пропущено.

--progressbox текст висота ширина

--progressbox висота ширина
A вікно прогресу подібний до хвостова коробка, крім цього

а) замість відображення вмісту файлу,
він відображає конвеєрний вихід команди та

b) він вийде, коли досягне кінця файлу
(немає кнопки «ОК»).

Якщо вказано три параметри, він відображає текст під заголовком, окреслений
із вмісту прокручуваного файлу. Якщо вказано лише два параметри, це текст
пропущено.

--радіст текст висота ширина висота списку [ тег пункт статус ] ...
A радіолист коробка схожа на a меню коробка. Різниця лише в тому, що ви можете
вказати, який запис на даний момент вибрано, встановивши його статус до on.

При виході записується тег вибраного елемента Діалог's вихід.

-- хвостова коробка файл висота ширина
Відобразити текст з файлу в діалоговому вікні, як у команді "tail -f". Прокрутка
вліво/вправо за допомогою 'h' і 'l' у стилі vi або клавіш зі стрілками. "0" скидає прокрутку.

При виході текст не записується Діалог's вихід. Надається лише кнопка «ОК».
для введення, але може бути повернуто статус виходу ESC.

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

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

+/- символи для збільшення/зменшення цифри на одиницю

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

Деякі клавіші також розпізнаються у всіх позиціях курсору:

додому/кінець
встановити значення на максимум або мінімум

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

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

Діалогове вікно особливо розглядає фонове завдання, якщо є інші віджети (--і-
віджет) на екрані одночасно. Поки ці віджети не будуть закриті (наприклад, an
"ДОБРЕ"), Діалог виконуватиме всі віджети tailboxbg в одному процесі,
опитування на оновлення. Ви можете використовувати вкладку для переходу між віджетами на
екран і закрийте їх окремо, наприклад, натиснувши ENTER. Колись не-
віджети tailboxbg закриті, Діалог розгалужує свою копію у фоновому режимі,
і друкує свій ідентифікатор процесу, якщо "--не вбивати« надається варіант.

При виході текст не записується Діалог's вихід. Надається лише кнопка «ВИХІД».
для введення, але може бути повернуто статус виходу ESC.

ПРИМІТКА. Старіші версії Діалог негайно роздвоївся та спробував оновити
екран окремо. Крім того, що він погано впливає на продуктивність, він був непрацездатним. Дещо
старі скрипти можуть не працювати належним чином зі схемою опитування.

--текстове вікно файл висота ширина
A текст поле дозволяє відображати вміст текстового файлу в діалоговому вікні. це є
як простий переглядач текстових файлів. Користувач може переміщатися по файлу за допомогою
курсор, сторінка вгору, сторінка вниз і ДОМАШНЯ/КІНЕЦЬ клавіші, доступні на більшості клавіатур. Якщо
рядки занадто довгі для відображення в полі, ЛІВО ПРАВО ключі можна використовувати для
прокручувати текстову область по горизонталі. Ви також можете використовувати клавіші в стилі vi h, j, k і l
замість клавіш курсору та B або N замість клавіш переміщення сторінки вгору та сторінку вниз.
Прокручуйте вгору/вниз за допомогою 'k' і 'j' в стилі vi або клавіш зі стрілками. Прокрутіть вліво/вправо за допомогою
'h' і 'l' в стилі vi або клавіші зі стрілками. "0" скидає прокрутку вліво/вправо. Для
більше зручності, також є функції пошуку вперед і назад у стилі vi
надано

При виході текст не записується Діалог's вихід. Надається лише кнопка «ВИХІД».
для введення, але може бути повернуто статус виходу ESC.

--часове вікно текст висота [шир годину хвилин другий]
Відкриється діалогове вікно, у якому можна вибрати годину, хвилину та секунду. Якщо
значення години, хвилини чи секунди відсутні або від’ємні, поточна дата
використовуються відповідні значення. Ви можете збільшити або зменшити будь-який з тих, що використовуються
стрілки вліво, вгору, вправо та вниз. Використовуйте вкладку або зворотну вкладку для переміщення між ними
вікна.

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

--Вигляд дерева текст висота ширина висота списку [ тег пункт статус глибина ] ...
Відображення даних, організованих у вигляді дерева. Кожна група даних містить тег, текст до
відображення елемента, його статусу ("включено" або "вимкнено") і глибини елемента в
дерево.

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

При виході записується тег вибраного елемента Діалог's вихід.

--так ні текст висота ширина
A так ні діалогове вікно розміру висота рядків ширина відображатимуться стовпці. The
рядок, визначений за допомогою текст відображається всередині діалогового вікна. Якщо цей рядок теж
довгий, щоб поміститися в один рядок, він буде автоматично розділений на кілька рядків на
відповідні місця. The текст рядок також може містити підрядок "\n"або
символи нового рядка `\n' для явного керування розривом рядка. Це діалогове вікно
корисно для постановки питань, на які потрібно відповісти так чи ні. The
діалогове вікно має a Так і a Немає кнопка, за допомогою якої користувач може перемикатися між
натиснувши кнопку TAB ключ

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

Коди, що використовуються для "Так" і "Ні", збігаються з тими, що використовуються для "ОК" і "Скасувати",
внутрішньо ніякої відмінності не робиться.

Застарілий Опції
-- звуковий сигнал Це було використано, щоб повідомити оригінальному cdialog, що він повинен подавати звуковий сигнал, коли
окремі процеси віджета tailboxbg будуть перефарбовувати екран.

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

ЧАС РОБІТ КОНФІГУРАЦІЯ

1. Створіть зразок файлу конфігурації, ввівши:

діалогове вікно --create-rc файл

2. На початку, Діалог визначає параметри, які потрібно використовувати, таким чином:

а) якщо змінна середовища DIALOGRC встановлено, його значення визначає назву
файлу конфігурації.

b) якщо файл у (а) не знайдено, скористайтеся ним $HOME/.dialogrc як конфігурація
файлу.

c) якщо файл у (b) не знайдено, спробуйте використати файл GLOBALRC, визначений за адресою
час компіляції, тобто /etc/dialogrc.

d) якщо файл у (c) не знайдено, використовуйте compiled за умовчанням.

3. Відредагуйте зразок конфігураційного файлу та скопіюйте його в інше місце Діалог можна знайти, як
зазначено на кроці 2 вище.

KEY ПРИВ'ЯЗКИ

Ви можете замінити або додати до прив’язок клавіш Діалог шляхом додавання до конфігураційного файлу.
Діалог's bindkey команда зіставляє окремі ключі зі своїм внутрішнім кодуванням.

bindkey віджет curses_key діалоговий_ключ

Команда віджет ім'я може бути "*" (усі віджети) або окремі віджети, наприклад текстове вікно. Конкретні
прив’язки віджетів замінюють прив’язки «*». Визначені користувачем прив’язки замінюють вбудовані
прив'язки.

Команда curses_key може бути будь-якою з назв, похідних від прокляття.ч, наприклад, "ДОПОМОГА" від
"KEY_HELP". Діалог також розпізнає контрольні символи ANSI, такі як "^A", "^?", а також
Елементи керування C1, такі як "~A" і "~?". Нарешті, він дозволяє екранувати будь-який окремий символ
із зворотною косою рискою.

ДіалогВнутрішні назви кодів ключів відповідають DLG_KEYS_ENUM введіть dlg_keys.h, наприклад,
"ДОВІДКА" від "DLGK_HELP".

Віджет імен
Деякі віджети (наприклад, поле форми) мають область, де можна редагувати поля. Ті
керується у підвікні віджета і може мати окремі прив’язки клавіш від основного
віджет, оскільки підвікна зареєстровані під іншим ім’ям.

Віджет Window ім'я Підвікно ІМ'Я
────────────────────────────────────────────
календарний календар
контрольний список контрольний список
editbox editbox editbox2

поле formbox formfield
fselect fselect fselect2
inputbox inputbox inputbox2
меню menubox меню
msgbox msgbox
пауза пауза
вікно прогресу
радіолист радіолист
tailbox tailbox
текстове поле текстове поле пошуку
таймбокс
так і є
────────────────────────────────────────────

Деякі віджети насправді є іншими віджетами, які використовують внутрішні налаштування для зміни поведінки.
Вони використовують ту саму назву віджета, що й фактичний віджет:

Віджет Фактичний Віджет
──────────────────────────────
dselect fselect
інформаційне поле повідомлення
меню введення
змішана форма
скринька введення пароля
форма пароля
prgbox progressbox
програмне поле прогресу
tailboxbg tailbox
──────────────────────────────

Вбудований палітурки
На цій сторінці посібника не вказано прив’язки клавіш для кожного віджета, оскільки вони детальні
інформацію можна отримати, запустивши Діалог. Якщо ви встановили --слід варіант Діалог
записує інформацію про прив'язку клавіш для кожного віджета в міру його реєстрації.

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

Деякі користувачі можуть захотіти використовувати ту саму клавішу для переміщення всередині частини редагування, що й для
перехід між кнопками. Віджет форми написаний для підтримки такого роду
перевизначення ключів шляхом додавання спеціальної групи в dlgk_keys.h для "форми"
(ліворуч/праворуч/наступний/попередній). Ось приклад зв'язування, що демонструє, як це зробити:

bindkey поле форми TAB form_NEXT
bindkey formbox TAB form_NEXT
bindkey поле форми BTAB form_prev
bindkey formbox BTAB form_prev

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

НАВКОЛИШНЄ СЕРЕДОВИЩЕ

ДІАЛОГОПТИ Визначте цю змінну, щоб застосувати будь-які загальні параметри до кожного віджета.
Більшість поширених параметрів скидаються перед обробкою кожного віджета. Якщо ти
встановити параметри в цій змінній середовища, до якої вони застосовуються Діалог's
стан після скидання. Як у "--файл", подвійні лапки і
інтерпретуються зворотні косі риски.

"--файл" параметр не вважається поширеним (тому ви не можете вставити
це в межах цієї змінної середовища).

DIALOGRC Визначте цю змінну, якщо ви хочете вказати ім’я конфігурації
файл для використання.

DIALOG_CANCEL

DIALOG_ERROR

DIALOG_ESC

DIALOG_EXTRA

DIALOG_HELP

DIALOG_ITEM_HELP

DIALOG_OK Визначте будь-яку з цих змінних, щоб змінити код виходу на Скасувати (1), помилка
(-1), ESC (255), Extra (3), Help (2), Help with --пункт-довідка (2) або ОК (0).
Зазвичай сценарії оболонки не можуть розрізняти -1 і 255.

DIALOG_TTY Встановіть для цієї змінної значення "1", щоб забезпечити сумісність зі старішими версіями
Діалог яка передбачала, що якщо скрипт перенаправляє стандартний вихід, то
"--stdout« був наданий варіант.

Використовуйте діалогове вікно онлайн за допомогою служб onworks.net