Události ve formulářích a mřížkách v modelem řízených aplikacích

Události iniciují veškerý kód na straně klienta. V modelem řízených aplikacích přidružíte konkrétní funkci v knihovně JavaScriptu (webový prostředek skriptu), která se má spustit při výskytu události. Tato funkce se nazývá obslužná rutina události. Každá obslužná rutina události určuje jednu funkci v knihovně JavaScriptu a všechny parametry, které lze funkci předat.

Obslužné rutiny událostí můžete přidružit pouze k některým událostem pomocí uživatelského rozhraní. Pro události, které nejsou k dispozici pro přidružení prostřednictvím uživatelského rozhraní, poskytuje rozhraní API klienta metody, které lze použít k připojení obslužných rutin událostí k těmto událostem.

Přidání nebo odebrání funkce obslužné rutiny události do události pomocí uživatelského rozhraní

Dědictví

Pomocí oddílu Obslužné rutiny událostí dialogového okna Vlastnosti formuláře přidružte skript k události pro formuláře a sloupce.

Sjednocené rozhraní

Přidání nebo odebrání funkcí obslužné rutiny událostí do událostí v novém sjednocené rozhraní:

1. Přejděte na Power Apps.

2. V levém navigačním podokně vyberte Data a pak vyberte Tabulky.

3. V seznamu tabulek vyberte tabulku, do které chcete přidat obslužné rutiny událostí.

4. Na panelu příkazů vyberte kartu Formuláře a pak vyberte formulář, do kterého chcete přidat.

   

5. Vyberte kartu Události . Všimněte si obslužných rutin událostí při uložení i při načítání .

   

6. Pokud chcete přidat obslužnou rutinu události pro událost při změně, vyberte sloupec a pak vyberte kartu Událost .

   

Hromadné úpravy formulářů

Ve výchozím nastavení se obslužné rutiny událostí nevolá, když je formulář v režimu hromadné úpravy.

Chcete-li povolit obslužnou rutinu události v režimu hromadné úpravy, upravte xml formuláře vyhledáním příslušného event elementu a vytvořením/nastavením atributu BehaviorInBulkEditForm na Enabled. V současné době se to podporuje jenom u událostí OnLoad.

Další informace o přizpůsobení XML formuláře naleznete v tématu Kdy upravit soubor přizpůsobení, Přizpůsobit formuláře a schéma XML formuláře.

Chcete-li zjistit, kdy obslužná rutina události je volána ve formuláři v režimu hromadné úpravy použití getFormType metody.

Přidání nebo odebrání funkce obslužné rutiny události do události pomocí kódu

Pomocí následujících metod přidejte a odeberte obslužnou rutinu události pro události, které nelze přidružit prostřednictvím uživatelského rozhraní:

Events	Obslužná rutina události
Atribut OnChange	metody addOnChange a removeOnChange
OnLoad formuláře	formContext.ui addOnLoad a removeOnLoad – metody
Načtený formulář	formContext.ui addLoaded a removeLoaded – metody
OnLoad dat formuláře	formContext.data addOnLoad a removeOnLoad – metody
Formulář při ukládání	metody addOnSave a removeOnSave
Ovládací prvek Vyhledávání PreSearch	addPreSearch a removePreSearch – metody
Kbsearch – ovládací prvek OnResultOpened	addOnResultOpened a removeOnResultOpened – metody
Kbsearch – ovládací prvek OnSelection	addOnSelection a removeOnSelection – metody
Kbsearch – ovládací prvek PostSearch	addOnPostSearch a removeOnPostSearch – metody

Důležité

Kontext spuštění se automaticky předá jako první parametr funkcím, které jsou nastavené pomocí kódu. Další informace: Kontext spouštění rozhraní API klienta

Kanál události formuláře

Pro každou událost můžete definovat až 50 obslužných rutin událostí. Každá obslužná rutina události se spustí v pořadí, v jakém je zobrazena v části Obslužné rutiny událostí na kartě Události v dialogovém okně Vlastnosti formuláře .

Pomocí metod setSharedVariable a getSharedVariable předejte společnou proměnnou mezi obslužné rutiny událostí (funkce). Použijte metodu getDepth kontextu spuštění ke zjištění posloupnosti, ve které se obslužná rutina události spouští vzhledem k jiným obslužným rutině událostí.

Související články

Vysvětlení objektového modelu klientského rozhraní API
Kontext spuštění rozhraní API klienta
Události (reference k rozhraní API klienta)