dialog - wyświetla dialogi ze skryptów
powłoki
dialog --clear
dialog --create-rc plik
dialog [ --title tytuł ] [ --backtitle
tytuł_tła ] [ --clear ] [
--separate-output ] opcje-okienka
Uwaga! To tłumaczenie może być
nieaktualne!
Dialog jest programem, który umożliwi Ci
prezentowanie różnych pytań lub wyświetlanie
komunikatów przy użyciu okienek dialogowych ze skryptu
powłoki. Obecnie rozpoznawane są następujące
okienka dialogowe:
yes/no box, menu box, input box,
message box, text box, info box, checklist
box, radiolist box i gauge box.
- --clear
- Ekran zostanie wyczyszczony po wyjściu z programu.
- --create-rc
plik
- Ponieważ dialog obsługuje konfigurację podczas
działania, można tego użyć do wygenerowania
przykładowego pliku konfiguracyjnego do podanego pliku.
- --separate-output
- Dla widgetów checklist, produkuj wyjście w osobnych liniach,
bez cytowania. Umożliwia to przetwarzanie przez inny program.
- --title
tytuł
- Podaje napis tytułu, który będzie
wyświetlony na górze okna dialogowego.
- --backtitle
tytuł_tła
- Podaje napis tytułu_tła, który będzie
wyświetlony w tle, na górze ekranu.
- Opcje
okienek
- --yesno tekst
wysokość szerokość
- Okienko dialogowe yes/no o wielkości
wysokość linii na szerokość
kolumn. Napis przekazywany jako tekst jest wyświetlany
wewnątrz okna dialogowego. Jeśli napis jest zbyt
długi, aby mógł się zmieścić w
linii, zostanie podzielony w odpowiednich miejscach na wiele linii. Napis
tekst może także zawierać podnapis
"\n" lub znaki nowej linii. `\n´,
umożliwiające ręczne kontrolowanie łamania
linii. To okienko dialogowe jest użyteczne do zadawania
pytań, które wymagają od użytkownika
odpowiedzi tak lub nie. Okienko dialogowe ma guzik Yesi guzik
No, między którymi użytkownik może
się przełączać, przyciskając klawisz
TAB.
- --msgbox tekst
wysokość szerokość
- Okienko msgbox jest bardzo podobne do okienka yes/no. Jedyna
różnica między nimi to to, że msgbox
posiada tylko pojedynczy guzik OK Możesz
używać tego okienka dialogowego do wyświetlania
komunikatów. Po przeczytaniu komunikatu, użytkownik
może nacisnąć klawisz ENTER, a dialog
dialog zakończy działanie i wywołujący
go skrypt będzie mógł kontynuować.
- --infobox
tekst wysokość szerokość
- okienko dialogowe infobox jest ogólnie podobne do
msgbox. Jednak w tym wypadku, dialog zakończy
działanie natychmiast po wyświetleniu wiadomości
użytkownikowi. Po zakończeniu ekran nie jest czyszczony,
więc wiadomość pozostanie na ekranie dopóki
skrypt jej nie wyczyści. Jest to użyteczne, jeśli
chcesz informować o przebiegu jakichś operacji, które
wymagają trochę czasu.
- --inputbox
tekst wysokość szerokość [init]
- Okienko dialogowe inputbox jest użyteczne gdy chcesz
zadawać pytania, które wymagają jakiegoś
napisu w odpowiedzi. Jeśli podano parametr init, to jest on
używany do zainicjowania napisu wejściowego. Podczas
pobierania napisu, BACKSPACE może być używany
do poprawiania literówek. Jeśli napis wejściowy jest
dłuższy niż rozmiar okienka, to zostanie
zaskrollowany. Po wyjściu, napis wejściowy zostanie
wydrukowany na stderr.
- --textbox plik
wysokość szerokość
- Okienko dialogowe textbox umożliwia wyświetlenie
zawartości pliku w okienku dialogowym. Jest to prosta
przeglądarka plików tekstowych. Użytkownik
może poruszać się w pliku, przyciskając
klawisze UP/DOWN, PGUP/PGDN i HOME/END. Jeśli
linie są zbyt długie, aby pomieścić się
w okienku, można je przewijać przy użyciu klawiszy
LEWO/PRAWO. Udostępniono również funkcje
przeszukiwania w przód i w tył.
- Jak wskazuje nazwa, okienko dialogowe menu jest okienkiem,
które może być używane do prezentowania listy
wyborów w postaci menu, z którego użytkownik wybiera
pozycję. Każdy wpis składa się z napisu
opisu i elementu. Element podaje wpisowi
nazwę, według której można go
odróżnić od innych wpisów w menu. Opis
jest krótkim opisem opcji, którą reprezentuje.
Użytkownik może przemieszczać się
między wpisami menu, wciskając klawisze
GÓRA/DÓŁ. Pierwsza litera elementu jest
skrótem. Mogą nimi być też cyfry 1-9.
Wyświetlanych jest wysokość-menu wpisów
naraz, lecz menu może być przewijane jeśli jest ich
więcej. Kiedy dialog kończy działanie, na stderr
drukowany jest element wybranej opcji.
- --checklist
tekst wysokość szerokość
wysokość-listy [element obiekt status ]
...
- Okienko dialogowe checklist jest podobne do okienka menu,
szczególnie w tym, że znajduje się tam wiele
wpisów prezentowanych w postaci menu. Zamiast wybierania wielu
wpisów, każdy z nich można
włączyć lub wyłączyć.
Początkowy stan włączenia/wyłączenia
jest określany przez status. Na koniec, na stderr drukowana
jest lista napisów elementów, których
ustawienia były włączone.
- --radiolist
tekst wysokość szerokość
wysokość-listy [element obiekt status ]
...
- Okienko dialogowe radiolist jest podobne do okienka menu.
Jedyną różnicą jest to, że
możesz wskazać, który wpis jest obecnie wybrany,
przez ustawienie jego statusu na on.
- --gauge tekst
wysokość szerokość procent
- Okienko gauge wyświetla miarkę na dole okienka.
Miarka określa procentowość. Nowe wartości
procentowe są odczytywane ze standardowego wejścia, jeden
integer na linię. Miarka jest odnawiana aby odzwierciedlić
każdy nowy procent. Okienko kończy działanie na EOF.
- 1.
- Utwórz przykładowy plik konfiguracyjny przy
użyciu:
"dialog --create-rc <file>"
- 2.
- Podczas uruchamiania dialog określa używane
ustawienia w następujący sposób:
- a)
- jeśli ustawiona jest zmienna środowiskowa DIALOGRC to
jej wartość określa nazwę pliku
konfiguracyjnego.
- b)
- jeśli nie znaleziono pliku (a), użyj pliku
$HOME/.dialogrc.
- c)
- jeśli plik (b) nie został znaleziony, użyj
wkompilowanych wartości domyślnych.
- 3.
- Edytuj przykładowy plik konfiguracyjny i skopiuj go w jakieś
miejsce, gdzie dialog może go znaleźć, jak
określono powyżej w kroku 2.
ŚRODOWISKO
- DIALOGRC
- Zdefiniuj tę zmienną, jeśli chcesz podać
nazwę używanego pliku konfiguracyjnego.
- $HOME/.dialogrc
- domyślny plik konfiguracyjny.
Status wyjścia jest 0, jeśli dialog
zakończył działanie po naciśnięciu guzika
Yes lub OK, a 1, jeśli wciśnięto guzik
No lub Cancel. W przeciwnym wypadku, jeśli
pojawią się błędy w dialogu lub gdy
dialog zostanie opuszczony przez naciśnięcie klawisza
ESC, status wyjścia wyniesie -1.
Pliki tekstowe, zawierające znaki tab mogą
powodować pewne problemy z textbox. Znaki tab w plikach
tekstowych muszą być najpierw rozwijane w spacje.
- Odświeżanie ekranu
jest zbyt wolne.
Savio Lam (lam836@cs.cuhk.hk) - wersja 0.3
Stuart Herbert (S.Herbert@sheffield.ac.uk) - patch dla wersji
0.4
Powyższe tłumaczenie pochodzi z
nieistniejącego już Projektu Tłumaczenia Manuali i
może nie być aktualne. W razie zauważenia
różnic między powyższym opisem a rzeczywistym
zachowaniem opisywanego programu lub funkcji, prosimy o zapoznanie
się z oryginalną (angielską) wersją strony
podręcznika za pomocą polecenia:
- man --locale=C 1 dialog
Prosimy o pomoc w aktualizacji stron man - więcej
informacji można znaleźć pod adresem
http://sourceforge.net/projects/manpages-pl/.