Scroll to navigation

DIALOG(1) General Commands Manual DIALOG(1)

NAZWA

dialog - wyświetla dialogi ze skryptów powłoki

SKŁADNIA

dialog --clear
dialog --create-rc plik
dialog [ --title tytuł ] [ --backtitle tytuł_tła ] [ --clear ] [ --separate-output ] opcje-okienka

OPIS

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.

OPCJE

Ekran zostanie wyczyszczony po wyjściu z programu.
Ponieważ dialog obsługuje konfigurację podczas działania, można tego użyć do wygenerowania przykładowego pliku konfiguracyjnego do podanego pliku.
Dla widgetów checklist, produkuj wyjście w osobnych liniach, bez cytowania. Umożliwia to przetwarzanie przez inny program.
Podaje napis tytułu, który będzie wyświetlony na górze okna dialogowego.
Podaje napis tytułu_tła, który będzie wyświetlony w tle, na górze ekranu.
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.
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ć.
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.
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.
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.
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.

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.

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.

KONFIGURACJA DZIAŁANIA

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:
jeśli ustawiona jest zmienna środowiskowa DIALOGRC to jej wartość określa nazwę pliku konfiguracyjnego.
jeśli nie znaleziono pliku (a), użyj pliku $HOME/.dialogrc.
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

Zdefiniuj tę zmienną, jeśli chcesz podać nazwę używanego pliku konfiguracyjnego.

PLIKI

$HOME/.dialogrc
domyślny plik konfiguracyjny.

DIAGNOSTYKA

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.

BŁĘDY

Pliki tekstowe, zawierające znaki tab mogą powodować pewne problemy z textbox. Znaki tab w plikach tekstowych muszą być najpierw rozwijane w spacje.

AUTOR

Savio Lam (lam836@cs.cuhk.hk) - wersja 0.3

Stuart Herbert (S.Herbert@sheffield.ac.uk) - patch dla wersji 0.4

10 czerwca 1994 Dialog wersja 0.6