RequestChoice
| Formát: | REQUESTCHOICE <TITLE> <body> {<gadgety>} [TYPE <typ>] [TO <soubor>] [PUBSCREEN <název veřejné obrazovky>] [TIMEOUTSECS <vteřiny>] [CHARSET <znaková sada>] [INACTIVE] |
| Šablona: | TITLE/A, BODY/A, GADGETS/A/M, TYPE/K, TO/K, PUBSCREEN/K, TIMEOUTSECS/K/N, CHARSET/K, INACTIVE/S |
| Účel: | Umožňuje AmigaDOS a ARexx skriptům používat vlastní dialogy |
| Cesta: | C:REQUESTCHOICE |
Číslo vybraného gadgetu bude zobrazeno jako výsledek v konzoli nebo se uloží do výstupního souboru. Jednotlivé gadgety jsou číslovány 1, 2, 3, ..., 0. Speciální výsledek -1 se zobrazí, když vyprší časový limit dialogu, -2 když byl použit argument INSERTDISK a byl vložen disk.
Pro vyhodnocení ve skriptech můžete tento výstup přesměrovat do proměnné. Pokud nelze dialog otevřít, příkaz vygeneruje se návratový kód 20.
Parametry
| TITLE | Upřesňuje název dialogu |
| BODY | Určuje text dialogu. Zalomení řádků lze dosáhnout zadáním *N. |
| GADGETS | Určuje text pro různé gadgety. Názvy gadgetů jsou odděleny mezerami. |
| TYPE | Určuje typ dialogu, který se má zobrazit. Možné typy jsou: INFO, QUESTION, WARNING, ERROR a INSERTDISKINFO. Pokud není tento argument zadán, INFO se předpokládá, když je zadán jeden název gadgetu, QUESTION naopak. |
| TO | určuje výstupní soubor, do kterého je výsledek zapsán. |
| TIMEOUTSECS | Určuje maximální počet sekund pro zobrazení dialogu před jeho uzavřením a vrácení výsledku -1. Tento argument vyžaduje třídu requester.class ve verzi minimálně 51.5. Zadáním hodnoty 0 znamená vypnutí tohoto časového limitu. Tento argument byl přidán ve verzi 51.4 příkazu REQUESTCHOICE. |
| PUBSCREEN | Umožňuje otevřít dialog na veřejné obrazovce. |
| CHARSET | Umožňuje určit znakovou sadu řetězců uvedených v argumentech BODY a GADGETS (argument TITLE je vždy zobrazen ve znakové sadě písma obrazovky). Tento argument byl přidán ve verzi 51.8 příkazu REQUESTCHOICE a vyžaduje třídu requester.class ve verzi 51.11. |
| INACTIVE | Určuje, že by okno dialogu otevření nemělo být aktivní. |
Příklad
| 1> Set rcnum `RequestChoice "New Title" "This is my requester*nSelect a gadget" "OK" "Maybe" "Cancel"` |
Místní proměnná rcnum obsahuje 1, 2 nebo 0 (příslušně) po výběru gadgetu. Skript může tuto hodnotu použít k řízení jeho pozdějšího spuštění.
