RequestString
| Formát: | REQUESTSTRING <TITLE> <body> [POSITIVE <text tlačítka OK>] [NEGATIVE <text tlačítka Zrušit>] [DEFSTRING <výchozí text>] [MAXLEN=<n>] [NOTEMPTY] INVISIBLE] [TO <soubor>] [PUBSCREEN <název veřejné obrazovky>] [CHARSET <znaková sada>] [INACTIVE] |
| Šablona: | TITLE/A, BODY/A, POSITIVE/K, NEGATIVE/K, DEFSTRING/K, MAXLEN/K/N, NOTEMPTY/S, INVISIBLE/S, TO/K, PUBSCREEN/K, CHARSET/K, INACTIVE/S |
| Účel: | Umožňuje AmigaDOS a ARexx skriptům používat vlastní textové dialogy |
| Cesta: | C:REQUESTSTRING |
Příkaz REQUESTSTRING vrátí jakémkoli problému návratový kód RETURN_FAIL (20), RETURN_WARN (5), pokud uživatel klikl na gadget pro zrušení a v ostatních případech RETURN_OK (0).
Výsledný řetězec (nebo výchozí řetězec, pokud uživatel zrušil dialog) bude uzavřen v uvozovkách a uložen do souboru určeného argumentem TO nebo aktuálního výstupního souboru.
Parametry
| TITLE | Upřesňuje název dialogu. |
| BODY | Určuje text dialogu. Zalomení řádků lze dosáhnout zadáním *N. Pro další možnosti formátování textu se podívejte na autodoc třídy requester.class. |
| POSITIVE | Určuje text pro tlačítko Ok. Výchozí je lokalizovaný text „_Ok“. |
| NEGATIVE | Určuje text pro tlačítko Zrušit. Výchozí je lokalizovaný text „_Cancel“. |
| DEFSTRING | Definuje výchozí text pro textový gadget. Výchozí hodnota je „“. |
| MAXLEN | Určuje maximální délku textového řetězce. Výchozí hodnota je 256. Délka nezahrnuje ukončení NUL, např. „A“ má délku 1. Záporné a nulové hodnoty jsou ignorovány a nahrazeny výchozí hodnotou. |
| NOTEMPTY | Neumožňuje uživateli zadat prázdný řetězec. |
| INVISIBLE | Určuje, že text v gadgetu by měl být zobrazen pomocí zástupných znaků „*“, např. zadávání hesel, která by neměla být viditelná pro osobu za uživatelem. |
| TO | Určuje soubor, kam se má uložit výsledný řetězec. Pokud není zadán, bude řetězec zapsán do aktuální výstupního souboru. |
| PUBSCREEN | Určuje název veřejné obrazovky, kam se má otevřít okno dialogu. Pokud není uvedeno, použije se aktuální výchozí veřejná obrazovka. Je-li to nutné, je před otevřením samotného dialogu přenesena do popředíveřejná obrazovka. Po uzavření dialogu je pak přenesena opět do pozadí, pokud tam byla původně. |
| CHARSET | Umožňuje určit znakovou sadu řetězců uvedených v argumentech BODY, POSITIVE, NEGATIVE a DEFSTRING. Argument TITLE je vždy zobrazen ve znakové sadě obrazovkového písma). Tento argument byl přidán ve verzi 51.8 příkazu REQUESTSTRING a vyžaduje třídu requester.class 51.11. |
| INACTIVE | Určuje, že by okno dialogu otevření nemělo být aktivní. |
Příklad
| 1> Set Title "Edit file comment" 1> Set Body "Comment for MyFile:" 1> Set Def "`List MyFile LFORMAT %c`" 1> Set Note `RequestString "$Title" "$Body" DEFSTRING "$Def"` 1> FileNote MyFile "$Note" |
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í.
