.\" {PTM/PB/0.1/09-05-1999/"wywietlaj okienka dialogowe ze skryptw powoki"}
.TH DIALOG 1 "10 czerwca 1994" "Dialog wersja 0.6"
.SH NAZWA
dialog \- wywietlaj dialogi ze skryptw powoki
.SH SKADNIA
.B dialog --clear
.br
.BI "dialog --create-rc " plik
.br
.B dialog
[
.B \-\-title
.I tytu
]
[
.B \-\-backtitle
.I tytuta
]
[
.B \-\-clear
]
[
.B \-\-separate\-output
]
.B opcje-okienka
.SH OPIS
.B Dialog
jest programem, ktry umoliwi ci prezentowanie rnych pyta lub
wywietlanie komunikatw przy uyciu okienek dialogowych ze skryptu powoki.
Obecnie rozpoznawane s nastpujce okienka dialogowe:
.LP
.BR yes/no " box," " menu" " box," " input" " box,"
.BR message " box," " text" " box," " info" " box,"
.BR checklist " box," " radiolist" " box, and" " gauge" " box."
.SH OCJE
.TP
.B \-\-clear
Ekran zostanie wyczyszczony po wyjciu na
.BR "atrybut ekranu" "."
.TP
.BI \-\-create-rc " plik"
.RB "Poniewa " dialog " obsuguje konfiguracj podczas dziaania,"
mona tego uy do wygenerowania przykadowego pliku konfiguracyjnego do
podanego \fIpliku\fR.
.TP
.BI \-\-separate\-output
Dla widgetw checklist, produkuj wyjcie w osobnych liniach, bez cytowania.
Umoliwia to przetwarzanie przez inny program.
.TP
.BI \-\-title " tytu"
Podaje napis
.IR tytuu ,
ktry bdzie wywietlony na grze okna dialogowego.
.TP
.BI \-\-backtitle " backtitle"
Pdaje napis
.IR tytuuta ,
ktry bdzie wywietlony w tle, na grze ekranu.
.TP
.B Opcje okienek
.TP
.BI \-\-yesno " tekst wysoko szeroko"
.RB "Okienko dialogowe" " yes/no" 
o wielkoci
.I wysoko
linii na
.I szeroko
kolumn. Napis przekazywany jako
.I tekst
jest wywietlany wewntrz okna dialogowego. Jeli napis jest zbyt dugi,
aby mg si zmieci w linii, zostanie podzielony w odpowiednich miejscach
na wiele linii.
Napis
.I tekst
moe take zawiera podnapis
.I
"\en"
lub znaki nowej linii.
.IR `\en\' ,
umoliwiajce rczne kontrolowanie amania linii. To okienko dialogowe jest
uyteczne do zadawania pyta, ktre wymagaj od uytkownika odpowiedzi tak
lub nie.
.RB "Okienko dialogowe ma guzik" " Yes" "i guzik " No,
midzy ktrymi uytkownik moe si przecza, przyciskajc klawisz
.IR TAB .
.TP
.BI \-\-msgbox " tekst wysoko szeroko"
.RB Okienko " msgbox" " jest bardzo podobne do okienka" " yes/no" "."
Jedyna rnica midzy nimi to to, e 
.B msgbox
posiada tylko pojedynczy guzik
.B OK
Moesz uywa tego okienka dialogowego do wywietlania komunikatw. Po
przeczytaniu komunikatu, uytkownik moe nacisn klawisz
.IR ENTER ,
a dialog
.B dialog
zakoczy dziaanie i wywoujcy go skrypt bdzie mg kontynuowa.
.TP
.BI \-\-infobox " tekst wysoko szeroko"
.RB "okienko dialogowe" " infobox" " jest oglnie podobne do" " msgbox."
Jednak w tym wypadku,
.B dialog
zakoczy dziaanie natychmiast po wywietleniu wiadomoci uytkownikowi. Po
zakoczeniu ekran nie jest czyszczony, wic wiadomo pozostanie na ekranie
dopki skrypt jej nie wyczyci. Jest to uyteczne, jesli chcesz informowa o
przebiegu jakich operacji, ktre wymagaj troch czasu.
.TP
.BI \-\-inputbox " tekst wysoko szeroko [init]"
.RB "Okienko dialogowe " inputbox
jest uyteczne gdy chcesz zadawa pytania, ktre wymagaj jakiego napisu w
odpowiedzi. Jeli podano parametr init, to jest on uywany do
zainicjalizowania napisu wejciowego. Podczas pobierania napisu,
.I BACKSPACE
moe by uywany do poprawiania literwek. Jeli napis wejciowy jest
duszy ni rozmiar okienka, to zostanie zaskrollowany. Po wyjciu, napis
wejciowy zostanie wydrukowany na
.IR stderr "."
.TP
.BI \-\-textbox " plik wysoko szeroko"
.RB "Okienko dialogowe" " textbox 
umozliwia wywietlenie zawartoci pliku w okienku dialogowym. Jest to prosta
przegldarka plikw tekstowych. Uytkownik moe porusza si w pliku,
przyciskajc klawisze
.IR UP/DOWN ", " PGUP/PGDN
.RI i " HOME/END" "."
Jeli linie s zbyt dugie, aby pomieci si w okienku, mona je przewija
przy uyciu klawiszy
.IR LEWO/PRAWO .
Udostpniono rwnie funkcje przeszukiwania w przd i w ty. 
.IP "\fB\-\-menu \fItekst wysoko szeroko wysoko-menu \fR[ \fIelement opis\fR] \fI..."
Jak wskazuje nazwa, okienko dialogowe
.B menu
jest okienkiem, ktre moe by uywane do prezentowania listy wyborw w
postaci menu, z ktrego uytkownik wybiera pozycj. Kady wpis skada si z
napisu
.IR opisu " i " elementu "."
.I Element
podaje wpisowi nazw, wedug ktrej mona go odrni od innych wpisw w
menu. 
.I Opis
jest krtkim opisem opcji, ktr reprezentuje. Uytkownik moe przemieszcza
si midzy wpisami menu, wciskajc klawisze
.IR GRA/Dӣ .
Pierwsza litera
.I elementu
jest skrtem. Mog nimi by te cyfry
.IR 1-9 ". Wywietlanych jest"
.I wysoko-menu
wpisw naraz, lecz menu moe by przewijane jeli jest ich wicej. Kiedy
dialog koczy dziaanie, na stderr drukowany jest
.I element
wybranej opcji.
.IP "\fB\-\-checklist \fItekst wysoko szeroko wysoko-listy \fR[\fIelement obiekt status \fR] \fI..."
.RB "Okienko dialogowe " checklist " jest podobne do okienka " menu ", sczeglnie w tym, e"
znajduje si tam wiele wpisw prezentowanych w postaci menu. Zamiast
wybierania wielu wpisw, kady z nich mona wczy lub wyczy. Pocztkowy
stan wczenia/wyczenia jest okrelany przez
.IR status "."
Na koniec, na stderr drukowana jest lista napisw
.IR elementw ,
ktrych ustawienia byy wczone.

.IP "\fB\-\-radiolist \fItekst wysoko szeroko wysoko-listy \fR [\fIelement obiekt status \fR] \fI..."
.RB "Okienko dialogowe " radiolist " jest podobne do okienka " menu ". Jedyn rnic jest to,"
e moesz wskaza, ktry wpis jest obecnie wybrany, przez ustawienie jego
.IR statusu " na " on "."

.IP "\fB\-\-gauge \fItekst wysoko szeroko procent\fR"
.RB "Okienko " gauge " wywietla miark na dole okienka.
Miarka okrela procentowo. Nowe wartoci procentowe s odczytywane ze
standardwego wejcia, jeden integer na lini. Miarka jest odnawiana aby
odzwierciedli kady nowy procent. Okienko koczy dziaanie na EOF.

.SH "KONFIGURACJA DZIAANIA"
.TP 4
1.
Utwrz przykadowy plik konfiguracyjny przy uyciu:
.LP
.in +1i
"dialog --create-rc <file>"
.TP 4
2.
Podczas uruchamiania 
.B dialog
okrela uywane ustawienia w nastpujcy sposb:
.RS
.TP 4
a)
jeli ustawiona jest zmienna rodowiskowa
.B DIALOGRC
to jej warto okrela nazw pliku konfiguracyjnego.
.TP 4
b)
jeli nie znaleziono pliku (a), uyj pliku
.IR $HOME/.dialogrc .
.TP 4
c)
jeli plik (b) nie zosta znaleziony, uyj wkompilowanych wartoci
domylnych.
.RE
.TP 4
3.
Wydytuj przykadowy plik konfiguracyjny i skopiuj go w jakie miejsce, gdzie
.B dialog
moe go znale, jak okrelono powyej w kroku 2.
.SH RODOWISKO
.TP 15
.B DIALOGRC
Zdefiniuj t zmienn, jeli chcesz poda nazw uywanego pliku
konfiguracyjnego.
.SH PLIKI
.TP 20
.I $HOME/.dialogrc
domylny plik konfiguracyjny.
.SH DIAGNOSTYKA
Status wyjcia jest 0, jeli
.BR dialog " zakoczy dziaanie po naciniciu guzika " Yes " lub " OK ","
a 1, jeli wcinito guzik
.BR No " lub " Cancel .
W przeciwnym wypadku, jeli pojawi si bdy w
.B dialogu
lub gdy 
.B dialog
zostanie opuszczony przez nacinicie klawisza
.IR ESC ,
status wyjcia wyniesie -1.
.SH BDY
Pliki tekstowe, zawierajce znaki
.I tab
mog powodowa pewne problemy z
.BR textbox .
Znaki
.I tab
w plikach tekstowych musz by najpierw rozwijane w spacje.
.TP
Odwieanie ekranu jest zbyt wolne.
.SH AUTOR
Savio Lam (lam836@cs.cuhk.hk) - wersja 0.3
.LP
Stuart Herbert (S.Herbert@sheffield.ac.uk) - patch dla wersji 0.4