Tartalom
Adatok
Licenc:
Verziószám: 1.3
Fejlesztő/tulajdonos: Savio Lam
Rövid leírás:
A dialog linux parancs manual oldala és súgója. A dialog olyan program, aminek segítségével sokféle kérdést vagy képernyőüzenetet lehet megjeleníteni, párbeszéddobozok segítségével, egy shell-scriptből. Jelenleg a következő típusú párbeszéddobozok alkalmazhatók: igen/nem doboz, menü doboz, bevitel doboz, üzenet doboz, szöveg doboz, infó doboz, választólista doboz, rádiólista doboz és mérték doboz.
A parancs a dialog csomag telepítése után használható.
Man oldal kimenet
man dialog
DIALOG(1) General Commands Manual DIALOG(1)
NÉV
dialog - párbeszéddobozokat jelenít meg shell-scriptekben
ÁTTEKINTÉS
dialog --clear
dialog --create-rc fájl
dialog [ --title cím ] [ --backtitle háttércím ] [ --clear ] [ --separate-output ]
doboz-opciók
LEÍRÁS
A dialog olyan program, aminek segítségével sokféle kérdést vagy képernyőüzenetet
lehet megjeleníteni, párbeszéddobozok segítségével, egy shell-scriptből. Jelenleg a
következő típusú párbeszéddobozok alkalmazhatók:
igen/nem doboz, menü doboz, bevitel doboz, üzenet doboz, szöveg doboz, infó doboz,
választólista doboz, rádiólista doboz és mérték doboz.
OPCIÓK
--clear
A képernyő a képernyő-attribútumnak megfelelően törlődik kilépéskor.
--create-rc fájl
Mivel a dialog lehetővé teszi a futás közbeni konfigurálást, ezt
felhasználhatjuk egy minta konfigurációs fájl létrehozására, ennek neve fájl.
--separate-output
A választólista-képernyőelemeknél a kimenet csak egy sort szolgáltat
egyszerre, idézőjelek nélkül. Ez megkönnyíti más programok számára a
továbbfeldolgozást.
--title cím
Beállítja a cím szövegét, ami a párbeszéddoboz tetején jelenik meg.
--backtitle háttércím
Beállítja a háttércím szövegét, ami a képernyő tetején, a háttérben fog
megjelenni.
Doboz-opciók
--yesno szöveg magasság szélesség
Egy igen/nem párbeszéddobozt jelenít meg, a magasság által megadott sor- és a
szélesség által megadott oszlopszámmal. A szöveg a párbeszéddoboz belsejében
fog megjelenni. Ha a szöveg túl hosszú ahhoz, hogy egy sorban elférjen, akkor
automatikusan feldarabolódik a megfelelő helyeken. A szöveg karakterlánc ezen
kívül tartalmazhat egy "\n" vagy `\n´ újsor al-karakterláncot is a sortörés
pontos vezérlésére. Ez a típusú doboz jól használható olyan kérdések
feltételére, amelyek a felhasználótól egy egyszerű igen vagy nem választ
várnak. A párbeszéddoboz tartalmaz egy Yes és egy No (Igen / Nem) gombot,
melyek között a felhasználó a TAB billentyű lenyomásával válthat.
--msgbox szöveg magasság szélesség
Az üzenet doboz nagyon hasonlít az igen/nem dobozhoz. Az egyetlen eltérés az
üzenet doboz és az igen/nem doboz között az, hogy az üzenet doboznak csak
egyetlen OK gombja van. Ez a doboz felhasználható bármilyen üzenet
kiíratására. Miután elolvasta az üzenetet, a felhasználó lenyomhatja az ENTER
billentyűt, ezáltal a dialog kilép és a hívó shell folytathatja a működését.
--infobox szöveg magasság szélesség
Egy infó doboz alapvetően egy üzenet doboz. Ebben az esetben azonban a
dialog az üzenet megjelenítése után azonnal kilép. A képernyőt nem törli le a
dialog kilépéskor, így az üzenet addig ott marad, amíg a hívó shell le nem
törli azt később. Ez akkor hasznos, ha informálni akarjuk a felhasználót
arról, hogy bizonyos még folyó műveletek igényelhetnek kis időt a
befejeződésükhöz.
--inputbox szöveg magasság szélesség [alapszöveg]
Az input doboz akkor hasznos, ha olyan kérdéseket akarunk feltenni, amire a
felhasználónak egy szöveggel kell válaszolnia. Ha az alapszöveg is meg van
adva, akkor ez lesz az alapértelmezett válasz-karakterlánc. A szöveg
bevitelekor a BACKSPACE gombot használhatjuk a gépelési hibák javítására. Ha a
beírt szöveg hosszabb annál, hogy beleférjen a beviteli mezőbe, akkor az
elgördül. Kilépéskor a bevitt szöveg a stderr hibacsatornára íródik ki.
--textbox fájl magasság szélesség
A szövegdoboz segítségével egy szövegfájl tartalmát jeleníthetjük meg egy
ablakban. Ez olyan, mint egy egyszerű szövegnézőke. A felhasználó mozoghat a
fájlban a FEL/LE, PGUP/PGDN és HOME/END billentyűkkel, amelyek a legtöbb
billentyűzeten megtalálhatók. Ha a sorok túl hosszúak ahhoz , hogy kiférjenek
az ablakban, akkor a BAL/JOBB gombok használhatók a szövegterület vízszintes
elmozgatására. A további kényelem szempontjából az előre- és hátrairányú
keresési funkciókat is megvalósították.
--menu szöveg magasság szélesség menü-magasság [ címke tétel ] ...
Ahogy a neve is mondja, a menü doboz egy olyan párbeszéddoboz, amely
megjelenít egy választási listát, amelyből a felhasználó választhat. Minden
menüpont egy címke karakterláncból és egy tétel karakterláncból áll. A címke
egy nevet ad a menüpontnak, ami megkülönbözteti a többi bejegyzéstől. A tétel
egy rövid leírása annak az opciónak, amit a menüpont jelent. A felhasználó
mozoghat a menüpontok között a FEL/LE nyilak lenyomásával, a címke első
betűjének mint forróbillentyűnek a lenyomásával, vagy az 1-9
számbillentyűkkel. Létezik menü-magasság bejegyzés is, ami megadja, hány
menüpont legyen egyszerre kiírva, de a menü elgördül, ha ennél több bejegyzés
van. Amikor a dialog kilép, a címke a kiválasztott menüpontból kiíródik a
stderr hibacsatornára.
--checklist szöveg magasság szélesség lista-magasság [ címke tétel állapot ] ...
A választólista hasonlít a menü dobozhoz abban, hogy több lehetőség közül
választhatunk egy menü formájában. Ahelyett azonban, hogy választanánk egyet a
menüpontok közül, minden bejegyzést ki- vagy bekapcsolhat a felhasználó. Az
eredeti ki/be állapotot az állapot szabályozza. Kilépéskor azok a címke
karakterláncok lesznek kiírva a stderr hibacsatornára, amelyeknek állapota
bekapcsolt.
--rádiólista szöveg magasság szélesség lista-magasság [ címke tétel állapot ] ...
A rádiólista doboz hasonló a menü dobozhoz. Az egyetlen eltérés az, hogy
beállítható, melyik menüpont van jelenleg kiválasztva, az állapot átváltásával
on-ra.
--gauge szöveg magasság szélesség százalék
A mérték doboz egy mértéksávot jelenít meg a doboz alján. A sáv jelzi a
százalékértéket. Új értékeket a szabványos bemenetről lehet beolvasni, egy
egész számot soronként. A sáv frissítődik, hogy jelezze az új százalékértéket.
Ha a bemenet XXX, a következő sorokat egészen a következő XXX-ig egy új
prompt-hoz használja fel a program. A bemeneten érkező EOF jelre fejeződik be
a sáv működése.
FUTÁS KÖZBENI KONFIGURÁCIÓ
1. Készítsünk egy példa konfigurációs fájlt a következők begépelésével:
"dialog --create-rc <fájl>"
2. Induláskor a dialog a következőképpen határozza meg a beállításokat:
a) ha a DIALOGRC környezeti változó be van állítva, ennek értéke adja meg a
konfigurációs fájl nevét.
b) ha az (a) alatti fájl nem található, a $HOME/.dialogrc fájl-t használja fel
mint konfigurációs fájlt.
c) ha a (b) alatti fájl sem található, akkor a fordításkori alapértékeket
használja.
3. Szerkesszük a minta konfigurációs fájlt és másoljuk olyan helyre, amit a dialog
megtalál, a 2. lépésben leírtak szerint.
KÖRNYEZET
DIALOGRC Állítsuk be ezt a változót, ha meg kívánjuk adni a használandó
konfigurációs fájl helyét.
FÁJLOK
$HOME/.dialogrc alapértelmezett konfigurációs fájl
DIAGNOSZTIKA
A kilépési kód 0, ha a dialog a Yes-el vagy az OK gomb lenyomásával ért véget, és 1,
ha a No vagy a Cancel gomb volt lenyomva. Egyébként, ha hiba fordul elő a dialog -on
belül vagy a dialog az ESC billentyű lenyomására lépett ki, a kilépési kód -1.
HIBÁK
A tab karaktereket tartalmazó szövegfájl-ok problémát okozhatnak a szöveg dobozban. A
tab karaktereket előzőleg szóközzé kell alakítani, ha meg akarjuk jeleníteni egy
szöveg dobozban.
A képernyőfrissítés túl lassú.
SZERZŐ
Savio Lam (lam836@cs.cuhk.hk) - 0.3 verzió
Stuart Herbert (S.Herbert@sheffield.ac.uk) - patch a 0.4 verzióhoz
MAGYAR FORDÍTÁS
Szijjártó László <laca@janus.gimsz.sulinet.hu>
Dialog Verzió 0.4 1994. Június 10. DIALOG(1)
Súgó kimenet
dialog --help
cdialog (ComeOn Dialog!) version 1.3-20190211
Copyright 2000-2017,2018 Thomas E. Dickey
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
* Display dialog boxes from shell scripts *
Usage: dialog <options> { --and-widget <options> }
where options are "common" options, followed by "box" options
Special options:
[--create-rc "file"]
Common options:
[--ascii-lines] [--aspect <ratio>] [--backtitle <backtitle>] [--beep]
[--beep-after] [--begin <y> <x>] [--cancel-label <str>] [--clear]
[--colors] [--column-separator <str>] [--cr-wrap] [--date-format <str>]
[--default-button <str>] [--default-item <str>] [--defaultno]
[--exit-label <str>] [--extra-button] [--extra-label <str>]
[--help-button] [--help-label <str>] [--help-status] [--help-tags]
[--hfile <str>] [--hline <str>] [--ignore] [--input-fd <fd>]
[--insecure] [--item-help] [--keep-tite] [--keep-window] [--last-key]
[--max-input <n>] [--no-cancel] [--no-collapse] [--no-cr-wrap]
[--no-items] [--no-kill] [--no-label <str>] [--no-lines] [--no-mouse]
[--no-nl-expand] [--no-ok] [--no-shadow] [--no-tags] [--nook]
[--ok-label <str>] [--output-fd <fd>] [--output-separator <str>]
[--print-maxsize] [--print-size]
[--print-text-only <text> <height> <width>]
[--print-text-size <text> <height> <width>] [--print-version] [--quoted]
[--reorder] [--scrollbar] [--separate-output] [--separate-widget <str>]
[--shadow] [--single-quoted] [--size-err] [--sleep <secs>] [--stderr]
[--stdout] [--tab-correct] [--tab-len <n>] [--time-format <str>]
[--timeout <secs>] [--title <title>] [--trace <file>] [--trim]
[--version] [--visit-items] [--week-start <str>] [--yes-label <str>]
Box options:
--buildlist <text> <height> <width> <list-height> <tag1> <item1> <status1>...
--calendar <text> <height> <width> <day> <month> <year>
--checklist <text> <height> <width> <list height> <tag1> <item1> <status1>...
--dselect <directory> <height> <width>
--editbox <file> <height> <width>
--form <text> <height> <width> <form height> <label1> <l_y1> <l_x1> <item1> <i_y1> <i_x1> <flen1> <ilen1>...
--fselect <filepath> <height> <width>
--gauge <text> <height> <width> [<percent>]
--infobox <text> <height> <width>
--inputbox <text> <height> <width> [<init>]
--inputmenu <text> <height> <width> <menu height> <tag1> <item1>...
--menu <text> <height> <width> <menu height> <tag1> <item1>...
--mixedform <text> <height> <width> <form height> <label1> <l_y1> <l_x1> <item1> <i_y1> <i_x1> <flen1> <ilen1> <itype>...
--mixedgauge <text> <height> <width> <percent> <tag1> <item1>...
--msgbox <text> <height> <width>
--passwordbox <text> <height> <width> [<init>]
--passwordform <text> <height> <width> <form height> <label1> <l_y1> <l_x1> <item1> <i_y1> <i_x1> <flen1> <ilen1>...
--pause <text> <height> <width> <seconds>
--prgbox <text> <command> <height> <width>
--programbox <text> <height> <width>
--progressbox <text> <height> <width>
--radiolist <text> <height> <width> <list height> <tag1> <item1> <status1>...
--rangebox <text> <height> <width> <min-value> <max-value> <default-value>
--tailbox <file> <height> <width>
--tailboxbg <file> <height> <width>
--textbox <file> <height> <width>
--timebox <text> <height> <width> <hour> <minute> <second>
--treeview <text> <height> <width> <list-height> <tag1> <item1> <status1> <depth1>...
--yesno <text> <height> <width>
Auto-size with height and width = 0. Maximize with height and width = -1.
Global-auto-size if also menu_height/list_height = 0.
Kapcsolódó tartalom
- 16 megtekintés