Akce polí se zprávami

Pole se zprávami můžete použít v desktopových tocích k interakci s uživateli, vyžádání vstupu a poskytnutí výstupu.

Chcete-li zobrazit zprávu uživateli během spuštění toku, použijte akci Zobrazit zprávu. Musíte zadat název okna se zprávou, jeho obsah, ikonu a tlačítka v okně, která se mají zobrazit. Kromě toho můžete nastavit výchozí tlačítko, které bude předvoleno, a také označit, zda má být okno se zprávou vždy nad všemi ostatními okny v počítači a zda se má po určité době automaticky zavřít.

Zde uvedený příklad znázorňuje okno se zprávou, která informuje uživatele, že analýza je dokončena, a zeptá se, zda se má analyzovat další soubor. Pole se zprávou zobrazuje ikonu otázky a je vždy nad ostatními okny. Výběr uživatele je uložen v proměnné ButtonPressed.

Vytvořené pole se zprávou by mělo vypadat jako v následujícím příkladu:

Kromě toho můžete vytvořit vlastní formulář pro zobrazení zprávy jako součást toku s pomocí akce Zobrazit vlastní formulář. Vlastní formulář pojme více prvků, takže můžete vytvořit vlastní formulář, který obsahuje různé typy vstupů a tlačítek. Další informace: Vytvoření vlastních formulářů.

Chcete-li vyžádat zadání dat pomocí dialogového okna, použijte akci Zobrazit dialogové okno pro zadání. Tato akce vyžaduje název dialogového okna a zprávu jako výzvu pro uživatele. Volitelně můžete nastavit výchozí hodnotu a typ vstupu (jednořádkový, víceřádkový nebo heslo).

Použijte akci Zobrazit dialogové okno pro výběr souboru, chcete-li vyzvat uživatele k vyhledání souboru. V následujícím příkladu budete vyzvání, abyste vybrali soubor obrázku. Proměnná určuje počáteční složku a filtr souborů omezuje výběr na konkrétní přípony souborů.

Vytvořené dialogové okno se souborem by mělo vypadat jako v následujícím příkladu. Zadaný filtr můžete vidět v pravém spodním rohu dialogového okna.

Zobrazit zprávu

Zobrazí okno se zprávou.

Vstupní parametry

Argument	Volitelné	Přijímá	Výchozí hodnota	Description
Message box title	Ano	Textová hodnota		Text, který se má použít jako název okna se zprávou
Message to display	Ano	Textová hodnota		Text, který se má zobrazit jako vlastní zpráva
Message box icon	Není k dispozici	Žádné, informace, otázka, varování, chyba	Nic	Ikona, která se má zobrazit s oknem se zprávou
Message box buttons	Není k dispozici	Dobře, OK - Zrušit, Ano - Ne, Ano - Ne - Zrušit, Zrušit - Opakovat - Ignorovat, Opakovat - Zrušit	OK	Tlačítka, která se mají zobrazit v okně se zprávami
Default button	Není k dispozici	První tlačítko, druhé tlačítko, třetí tlačítko	První tlačítko	Ve výchozím nastavení tlačítko pro zvýraznění. Pokud uživatel stiskne Enter, toto tlačítko bude stisknuto
Udržovat okno se zprávou vždy nahoře	Není k dispozici	Logická hodnota	False	Určete, zda má okno se zprávou vždy zůstat nad všemi ostatními okny
Close message box automatically	Není k dispozici	Logická hodnota	False	Určete, zda se okno se zprávou automaticky zavře po nastaveném čase, jako by bylo stisknuto výchozí tlačítko. Jinak tok počká, dokud uživatel nestiskne tlačítko
Timeout	Ano	Číselná hodnota	3	Čas v sekundách, po který bude automatizace pozastavena při čekání na vstup, dokud nebude automaticky pokračovat

Vytvořené proměnné

Argument	Type	Description
ButtonPressed	Textová hodnota	Text stisknutého tlačítka

Výjimky

Výjimka	Popis
Zobrazení pole zprávy se nezdařilo	Označuje problém se zobrazením dialogu zprávy
Nelze zobrazit pole zprávy v neinteraktivním režimu	Označuje problém se zobrazením dialogu zprávy v neinteraktivním režimu

Zobrazit dialog vstupu

Zobrazí dialogové okno, které uživatele vyzve k zadání textu.

Vstupní parametry

Argument	Volitelné	Přijímá	Výchozí hodnota	Description
Input dialog title	Ano	Textová hodnota		Název dialogu
Input dialog message	Ano	Textová hodnota		Zpráva dialogu
Default value	Ano	Textová hodnota		Zadejte text, který se má zobrazit jako výchozí. Pokud si uživatel přeje změnit tento text, může ho přepsat. Jinak se použije výchozí text
Input type	Není k dispozici	Jeden řádek, heslo, víceřádkový	Jeden řádek	Formát vstupního textu. Zvolte Jeden řádek - heslo pro skrytí textu, nebo více řádků, aby větší pole zobrazení zviditelnilo více než jeden řádek textu
Keep input dialog always on top	Není k dispozici	Logická hodnota	False	Určete, zda má dialog vstupu vždy zůstat nad všemi ostatními okny

Vytvořené proměnné

Argument	Type	Description
UserInput	Textová hodnota	Text zadaný uživatelem, nebo výchozí text
ButtonPressed	Textová hodnota	Text stisknutého tlačítka. Uživateli bude automaticky nabídnuta volba OK nebo Zrušit.

Výjimky

Výjimka	Popis
Zobrazení dialogu vstupu se nezdařilo	Označuje problém se zobrazením dialogu vstupu
Nelze zobrazit dialog vstupu v neinteraktivním režimu	Označuje problém se zobrazením dialogu vstupu v neinteraktivním režimu

Zobrazit dialog výběru data

Zobrazí dialogové okno, které uživatele vyzve k zadání data nebo rozsahu dat.

Vstupní parametry

Argument	Volitelné	Přijímá	Výchozí hodnota	Description
Dialog title	Ano	Textová hodnota		Název dialogu
Dialog message	Ano	Textová hodnota		Zpráva dialogu
Dialog type	–	Jedno datum, rozsah dat (dvě data)	Jedno datum	Zda uživatel zadá jedno datum nebo dvě data jako koncové body rozsahu dat
Prompt for	Není k dispozici	Pouze datum, datum a čas	Pouze datum	Určete, zda uživatel zadá pouze datum, nebo datum a čas
Default value	Ano	Datum a čas		Výchozí hodnota pro datum
Default value for second date	Ano	Datum a čas		Výchozí hodnota pro koncové datum rozsahu
Keep date selection dialog always on top	Není k dispozici	Logická hodnota	False	Určete, zda má dialog výběru data vždy zůstat nad všemi ostatními okny

Vytvořené proměnné

Argument	Type	Description
SelectedDate	Datum a čas	Datum zadané uživatelem, nebo výchozí datum
SecondSelectedDate	Datum a čas	Druhé datum zadané uživatelem, nebo toto výchozí datum
ButtonPressed	Textová hodnota	Text stisknutého tlačítka uživatelem. Uživateli bude automaticky nabídnuta volba OK nebo Zrušit.

Výjimky

Výjimka	Popis
Zobrazení dialogu výběru data se nezdařilo	Označuje problém se zobrazením dialogu výběru data
Nelze zobrazit dialog výběru data v neinteraktivním režimu	Označuje problém se zobrazením dialogu vstupu v neinteraktivním režimu

Zobrazit výběr ze dialogu seznamu

Zobrazí dialogové okno s možnostmi, které umožňují uživateli vybírat ze seznamu.

Vstupní parametry

Argument	Volitelné	Přijímá	Výchozí hodnota	Description
Dialog title	Ano	Textová hodnota		Název dialogu
Dialog message	Ano	Textová hodnota		Zpráva dialogu
List to choose from	Ne	Obecná hodnota		Seznam, který se zobrazí jako rozevírací nabídka, ze které si uživatel může vybrat
Keep select dialog always on top	Není k dispozici	Logická hodnota	False	Určete, zda má dialog výběru vždy zůstat nad všemi ostatními okny
Limit to list	Není k dispozici	Logická hodnota	True	Zda umožnit uživateli zadat vlastní odpověď mimo zobrazený seznam
Allow empty selection	Není k dispozici	Logická hodnota	False	Umožnit uživateli nevybírat nic a vytvořit prázdný vybraný výstup položky
Povolit vícenásobný výběr	–	Logická hodnota	False	Umožněte uživateli vybrat více než jednu možnost. Vybraná položka a vybrané proměnné indexu budou obsahovat seznam položek
Preselect items starting with a + sign	Není k dispozici	Logická hodnota	False	Určete, zda se položky s předřazeným znaménkem + zobrazí automaticky předvolené

Vytvořené proměnné

Argument	Type	Description
SelectedItem	Textová hodnota	Položka vybraná ze seznamu jako text
SelectedItems	Seznamtextových hodnot	Položky vybrané ze seznamu jako seznam textu
SelectedIndex	Číselná hodnota	Indexové číslo položky vybrané ze seznamu. Místo celého textu volby můžete použít číslo položky
SelectedIndexes	Seznamčíselných hodnot	Indexové číslo položek vybraných ze seznamu. Tento parametr vám umožňuje použít číslo položky namísto celého textu volby
ButtonPressed	Textová hodnota	Název tlačítka stisknutého uživatelem (OK nebo Zrušit)

Výjimky

Výjimka	Popis
Zobrazení dialogu výběru se nezdařilo	Označuje problém se zobrazením dialogu výběru
Nelze zobrazit dialog výběru v neinteraktivním režimu	Označuje problém se zobrazením dialogu vstupu v neinteraktivním režimu

Zobrazit dialog výběru souboru

Zobrazí dialog výběru souboru a vyzve uživatele k výběru jednoho nebo více souborů.

Vstupní parametry

Argument	Volitelné	Přijímá	Výchozí hodnota	Description
Dialog title	Ano	Textová hodnota		Název dialogu
Initial folder	Ano	Složka		Počáteční složka, která se má otevřít při hledání souboru. Tato složka je místo, kde akce dialogového okna Vybrat soubor spustí uživatele, který hledá soubory
Filtr souborů	Ano	Textová hodnota		Filtr pro omezení načítaných souborů. Tento parametr umožňuje zástupné znaky, například „.txt“ nebo „document?.doc“ (bez uvozovek). Chcete-li povolit uživateli výběr z více filtrů souborů, oddělte volby středníkem, například „txt;*.exe“
Keep file selection dialog always on top	Není k dispozici	Logická hodnota	False	Zda má dialog výběru souboru vždy zůstat nad všemi ostatními okny
Povolit vícenásobný výběr	–	Logická hodnota	False	Zda bude uživatel moci vybrat více než jeden soubor
Check if file exists	Není k dispozici	Logická hodnota	False	Zda budou přijaty pouze soubory, které již existují

Vytvořené proměnné

Argument	Type	Description
SelectedFile	Soubor	Soubor, který bude vybrán prostřednictvím dialogu
SelectedFiles	Seznamsouborů	Vybrané soubory
ButtonPressed	Textová hodnota	Text stisknutého tlačítka. Uživateli bude automaticky nabídnuta volba Otevřít nebo Zrušit

Výjimky

Výjimka	Popis
Zobrazení dialogu výběru souboru se nezdařilo	Označuje problém se zobrazením dialogu výběru souboru
Nelze zobrazit dialog výběru souboru v neinteraktivním režimu	Označuje problém se zobrazením dialogu vstupu v neinteraktivním režimu

Zobrazit dialog výběru složky

Zobrazí dialog výběru složky a vyzve uživatele k výběru složky.

Vstupní parametry

Argument	Volitelné	Přijímá	Výchozí hodnota	Description
Dialog description	Ano	Textová hodnota		Popis dialogu pro výběru složky, například „Vyberte složku, do které chcete zkopírovat soubory“
Initial folder	Ano	Složka		Počáteční složka, která se má otevřít. Tato složka bude výchozí složka, pokud si uživatel nevybere novou
Keep folder selection dialog always on top	Není k dispozici	Logická hodnota	False	Zda má dialog výběru složky vždy zůstat nad všemi ostatními okny

Vytvořené proměnné

Argument	Type	Description
SelectedFolder	Složka	Vybraná složka
ButtonPressed	Textová hodnota	Text stisknutého tlačítka. Uživateli bude automaticky nabídnuta volba OK nebo Zrušit.

Výjimky

Výjimka	Popis
Zobrazení dialogu výběru složky se nezdařilo	Označuje problém se zobrazením dialogu výběru složky
Nelze zobrazit dialog výběru složky v neinteraktivním režimu	Označuje problém se zobrazením dialogu vstupu v neinteraktivním režimu

Zobrazení vlastního formuláře

Zobrazte přizpůsobený formulář, který může obsahovat více typů prvků, jako je text, číslo nebo souborové vstupy atd.

Vstupní parametry

Vstupní parametry se konfigurují pomocí návrháře vlastních formulářů.

Vytvořené proměnné

Argument	Type	Description
CustomFormData	Vlastní objekt	Vlastní objekt obsahující vstup uživatele
ButtonPressed	Textová hodnota	ID stisknutého tlačítka

Výjimky

Výjimka	Description
Nepodařilo se zobrazit vlastní formulář	Označuje problém se zobrazením vlastního formuláře