SLRN - Super Page
 

Wewnętrzne funkcje slrn 
> Instalacja i konfiguracja > Podręcznik > FAQ > Pozostała dokumentacja
poziom wyżej

Następna Poprzednia Spis treści

4. Funkcje dialogowe i informacyjne

Niniejszy rozdział opisuje funkcje interakcyjne czytnika.

4.1 get_response

Składnia

Integer get_response (String choices, String prompt)

Opis

Funkcja ta oczekuje na wprowadzenie przez użytkownika pojedynczego znaku z klawiatury, prezentując zachętę podaną drugim argumentem wywołania. Pierwszy argument, choices określa znaki, które zostaną zaakceptowane. Każdy znak podany w argumencie prompt poprzedzony przez \001 otrzyma kolor obiektu response_char.

Przykład

Poniższe wywołanie:

       rsp = get_response ("tTbB", "Lubisz koty? \001Tak, \001Bardzo");
umieści jeden ze znaków t, T, b, lub B w zmiennej rsp.
Zobacz również

get_yes_no_cancel, set_color, get_select_box_response

4.2 get_select_box_response

Składnia

Integer get_select_box_response (title, item_1, ..., n_items)

Opis

Funkcja wyświetla na ekranie okno wyboru i oczekuje na decyzję użytkownika. Zwracana wartość całkowita odpowiada wybranej pozycji.

Przykład

       variable rsp = get_select_box_response (
                         "Wybierz liczbę:",
                         "jeden", "dwa", "trzy", "cztery",
                         4);
       message (sprintf ("Wybrałeś %d", rsp));
Zobacz również

read_mini, message, get_yes_no_cancel, get_response, select_list_box

4.3 get_yes_no_cancel

Składnia

Integer get_yes_no_cancel (str)

Opis

Funkcja wyświetla napis zadany argumentem str w wierszu poleceń slrn po dopisaniu do niego "? [Y]-es, N-o, C-ancel". Następnie oczekuje na odpowiedź użytkownika i zwraca:

        1 jeśli wybrano "yes"
        0 jeśli wybrano "no"
       -1 jeśli wybrano "cancel"
Uwagi

Jeśli zachodzi potrzeba wyświetlenia znaku procenta, należy go podwoić.

Zobacz również

get_select_box_response, getkey, read_mini, select_list_box

4.4 message_now

Składnia

Void message_now (String_Type s)

Opis

Funkcja natychmiast wyświetla napis s w obszarze komunikatów.

Zobacz również

message, vmessage, error

4.5 popup_window

Składnia

Int popup_window (String title, String tekst)

Opis

Funkcja ta tworzy okno zatytułowane title zawierające podany tekst. Zwraca kod klawisza użytego do zamknięcia okna.

Uwagi

Począwszy od wersji slrn 0.9.7.4, funkcja obsługuje poprawnie znaki Tab zawarte z napisie tekst. Znaki Tab w tytule (title) nie są obsługiwane i nie należy ich tam umieszczać.

Zobacz również

select_list_box

4.6 read_mini

Składnia

String read_mini (String p, String dflt, String init)

Opis

Funkcja wyświetla zachętę p i oczekuje na wprowadzenie napisu przez użytkownika. Argument dflt pozwala na podanie wartości domyślnej. Jeśli argument init nie jest pustym napisem, będzie dostępny do edycji przez użytkownika.

Zobacz również

read_mini_filename, read_mini_no_echo, read_mini_integer, read_mini_variable, getkey, set_input_string, set_input_chars

4.7 read_mini_filename

Składnia

String read_mini_filename (String p, String dflt, String init)

Opis

Funkcja ta działa podobnie jak read_mini, ale dodatkowo pozwala na dopełnianie nazw plików.

Zobacz również

read_mini, read_mini_variable, getkey, set_input_string, set_input_chars

4.8 read_mini_integer

Składnia

Integer read_mini_integer (String p, Integer dflt)

Opis

Funkcja wyświetla zachętę p i czeka na wprowadzenie przez użytkownika liczby całkowitej. Argument dflt stanowi wartość domyślną.

Zobacz również

read_mini

4.9 read_mini_no_echo

Składnia

String read_mini_no_echo (String p, String dflt, String init)

Opis

Funkcja ta działa podobnie jak read_mini, ale nie wyświetla na ekranie wprowadzanego tekstu.

Zobacz również

read_mini, getkey, set_input_string, set_input_chars

4.10 read_mini_variable

Składnia

String read_mini_variable (String p, String dflt, String init)

Opis

Funkcja ta działa podobnie jak read_mini, ale dodatkowo pozwala na dopełnianie nazw zmiennych konfiguracyjnych slrn.

Zobacz również

read_mini, read_mini_filename, getkey, set_input_string, set_input_chars

4.11 select_list_box

Składnia

String_Type select_list_box (title, s_1, ... s_n, n, active_n)

    String_Type title, s_1, ... s_n
    Int_Type n, active_n
Opis

Przeznaczeniem tej funkcji jest wyświetlenie listy n napisów określonych argumentami s_1, ... s_n i umożliwienie użytkownikowi wybrania jednego z nich. Wyboru dokonuje się takimi samymi klawiszami jak w select_box_response. Tytuł okna określony jest argumentem title. Argument active_n określa wybór domyślny. Funkcja zwraca napis wybrany przez użytkownika.

Zobacz również

get_select_box_response, get_response

4.12 set_input_chars

Składnia

Void set_input_chars (String val)

Opis

Funkcja ta służy do ustawienia znaku, który zostanie zwrócony przez następne wprowadzenie pojedynczego znaku w wierszu poleceń slrn. Na ten rodzaj wejścia oczekuje funkcja get_response.

Przykład

       set_input_chars ("t");
       if ('t' == get_yes_no_cancel ("Naprawdę masz dość?"))
         quit (0);
Zobacz również

set_input_string, get_response, get_yes_no_cancel

4.13 set_input_string

Składnia

Void set_input_string (String val)

Opis

Funkcja ta służy do ustawienia ciągu znaków, które zostaną zwrócone przy następnym oczekiwaniu na wprowadzenie napisu w wierszu poleceń slrn. Można ustawić więcej niż jedną wartość, oddzielając napisy znakami \n.

Przykład

Poniższy fragment kodu:

       variable a, b;
       set_input_string ("Jajko\nKura");
       a = read_mini ("Co było pierwsze?", "", "");
       b = read_mini ("A co było potem?", "", "");
nada zmiennej a wartość Jajko, a zmiennej b wartość Kura.
Zobacz również

read_mini, set_input_chars


Następna Poprzednia Spis treści

Funkcje slrn

1. Funkcje obsługujące nagłówki i wątkowanie

2. Funkcje dostępne w trybie artykułów

3. Funkcje dostępne w trybie grup

4. Funkcje dialogowe i informacyjne

5. Interakcja z użytkownikiem

6. Obsługa plików

7. Inne funkcje

8. Funkcje obsługi zdarzeń (Hooks)


projekt www: loop Piotr Gogolin
[ strona wygenerowana z CVS: 07.06.2002 20:25 ]