Sfairadora

  • Referenční příručka

select_file_name

select_file_name(výchozí, filtr, přípona, příznaky)
select_file_name(výchozí, filtr, přípona, příznaky, titulek)
Funkce zobrazí standardní dialogové okno operačního systému pro výběr názvu jednoho souboru.

Parametry

výchozí
parametr typu String obsahující výchozí složku a/nebo název souboru. Pokud řetězec končí zpětným lomítkem (\), chápe se jako výchozí složka bez názvu souboru.
přípona
parametr typu String určující příponu, která se připojí k uživatelem zadanému názvu souboru, pokud uživatel žádnou příponu neuvedl. Přípona se uvádí bez tečky (např. “txt”). Pokud je zadán prázdný řetězec, žádná přípona se nepřipojuje.
filtr
seznam typů souborů. Typ parametru je Seq(String[2]), tj. sekvence dvojic řetězců. V každé dvojici udává první řetězec masku, podle které se zobrazuje seznam souborů, druhý parametr je popis, který se zobrazuje uživateli. Pokud je třeba zadat masku více typů souborů, oddělí se středníkem. Například: {{“*.jpg; *.jpe; *.jpeg”, “Obrázky JPEG”}, {“*.gif”, “Obrázky GIF”}}.
příznaky
parametr typu Int určující vlastnosti okna pro výběr souboru. Jedna z konstant pro výběr názvu souboru.
titulek
parametr typu String. Pokud je zadán, obsahuje titulek dialogového okna. Pokud zadán není, použije se standardní titulek („Otevřít“ nebo „Uložit jako“).

Výsledek

Výsledkem je typ File_name (pojmenovaný typ řetězec (String)) obsahující plnou cestu k vybranému souboru. Pokud uživatel zruší výběr tlačítkem Storno, výsledkem je prázdný řetězec.

Viz též