Загальні опції ¶

--aspect співвідношення

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

--backtitle титул

Вказує титул, що буде відображено на декорації, зверху екрану.

--begin y x

Вказує положення на екрані верхнього лівого кута діалогової скриньки.

--cancel-label ланцюжок

Переважить надпис, використовуваний для кнопки скасовування; стандартно - "Cancel".

--clear

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

Усі три скриньки видимі, створює всхідний ефект, у послідовності 1,2,3:

          dialog                         --begin 2 2 --yesno "" 0 0 \


              --and-widget               --begin 4 4 --yesno "" 0 0 \


              --and-widget               --begin 6 6 --yesno "" 0 0

Тільки останню скриньку залишено видимою:

          dialog           --clear       --begin 2 2 --yesno "" 0 0 \


              --and-widget --clear       --begin 4 4 --yesno "" 0 0 \


              --and-widget               --begin 6 6 --yesno "" 0 0

          dialog           --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

          dialog           --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

--colors

Інтерпретувати вбудовані в dialog атрибутивні послідовності, що складаються з "\Z" із послідуючим числом від 0 до 7, що являються кодом ANSI для таких кольорів, як чорний, червоний, зелений, жовтий, синій, пурпуровий, ціановий і білий, відповідно. Додатковими атрибутами є жирний шрифт, що встановлюється літерою 'b' і скасовується 'B', інверсне зображення, встановлюване 'r' і скасовуване 'R', підкреслення, встановлюване 'u' і скасовуване 'U'. Ці коди є кумулятивними, тобто "\Zb\Z1" виведе наступний текст жирним шрифтом червоного кольору. Щоб відновити звичайні кольори, використайте "\Zn".

--cr-wrap

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

Подивіться також опції --no-collapse і --trim.

--create-rc файл

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

--defaultno

Обирає "No" стандартною відповіддю скриньки так/ні (yes/no). Аналогічно, робить стандартною відповіддю "Cancel" для скриньок з <ОК> і <Cancel>. Якщо одночасно надано --nocancel або --visit-items, вони переважать, обираючи стандартною відповіддю завжди "Yes" (внутрішньо те саме, що "OK").

--default-item ланцюжок

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

--exit-label ланцюжок

Встановлює надпис для кнопки виходу, типово <EXIT>.

--extra-button

Виведе додаткову кнопку між <OK> і <Cancel>.

--extra-label ланцюжок

Переважить надпис, використовуваний для додаткових кнопок. Примітка: для ввідних меню, надписом за замовчуванням є "Rename" (перейменувати).

--help

Виводить допомогу по вживанню програми. Повідомлення з допомогою також з'явиться, якщо жодних опцій командного рядка не було надано dialog .

--help-button

Виведе кнопку допомоги після <OK> і <Cancel>, тобто у контрольних переліках, радіо-переліках і скриньках меню. Якщо одночасно надано --item-help, під час завершення, статус виходу буде тим самим, що й у випадку клавіші <OK> і текст, вказаний --item-help з'явиться як вивід dialog після позначки "HELP". У протилежному випадку, статус завершення вказуватиме на те, що було притиснуто клавішу <Help> і жодного повідомлення не з'явиться.

--help-label ланцюжок

Переважить надпис клавіші <Help>.

--help-status

Якщо було обрано кнопку допомоги, перезапише таблицю контрольного переліку, радіопереліку або форми після виводу довідки, вказаної --item-help. Це можна використовувати для відновлення стану контрольного переліку після обробки запиту допомоги.

--ignore

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

--input-fd дескриптор_файлу

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

--insecure

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

--item-help

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

--keep-window

Звично, коли dialog здійснює декілька віконець .BР tailboxbg , об'єднаних за допомогою --and-widget, попереднє віконце зникає через перезапис його новим. Користуйтеся цією опцією, щоб пригнітити цей перезапис.

Під час виходу, dialog перезаписує усі віконця, позначені --keep-window, навіть якщо вони не являються tailboxbg. Це спричиняє до перезапису їх у оберненій послідовності. Подивіться обговорення опції --clear для прикладів.

--max-input розмір

Обмежує ввовимі ланцюжки до вказаного розміру. Якщо розмір не задано, обмеженням буде 2048 знаків.

--no-cancel

--nocancel
Прибирає кнопку <Cancel> з контрольних переліків, скриньок вводу тексту і меню. Скрипт усе ще в змозі перевірити, чи користувач натиснув клавішу ESC, для скасування дії.

--no-collapse

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

--no-kill

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

--no-label ланцюжок

Переважить надпис, використовуваний для кнопок <No>.

--no-shadow

Пригнічує тінь, що відображається справа і внизу кожної діалогової скриньки.

--ok-label ланцюжок

Переважить надпис, використовуваний для кнопок <OK>.

--output-fd дескриптор

Перенаправить вивід до вказаного дескриптору файлу. Більшість скриптів dialog пишуть до стандартного пристрою помилки, але туди можна також записувати, власне, повідомлення про помилки, в залежності від вашого скрипту.

--print-maxsize

Виведе максимальний розмір діалогових скриньок, тобто розмір екрану, при виході dialog. Цю опцію можна використовувати окремо, без додаткових опцій.

--print-size

Виведе розмір кожної діалогової скриньки при виході dialog.

--print-version

Виведе версію програми. Цю опцію можна використовувати окремо.

--separate-output

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

--separator ланцюжок

--separate-widget ланцюжок
Вказати ланцюжок, що поділятиме вивід dialog для кожного елементу інтерфейсу. Це використовується для полегшення обробки виводу dialog з декількома елементами інтерфейсу.

--shadow

Виводить тінь зправа і знизу кожного віконця dialog.

--single-quoted

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

--size-err