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

        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.

OPCJE

       --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ł.

       --menu tekst wysokość szerokość wysokość-menu [ element opis] ...
              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.

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:

           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.

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.

       Odświeżanie ekranu jest zbyt wolne.

AUTOR

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

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

INFORMACJE O TŁUMACZENIU

       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/.