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

Události ve formulářích a mřížkách 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é nemůžete přidružit prostřednictvím uživatelského rozhraní, poskytuje rozhraní API klienta metody, které můžete použít k připojení obslužných rutin událostí.

Přidání nebo odebrání funkcí obslužné rutiny událostí ve formulářích pomocí uživatelského rozhraní

Přidání nebo odebrání funkcí obslužné rutiny událostí pro události 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 obslužnou rutinu události.

    Snímek obrazovky s kartou Formuláře zobrazující seznam formulářů pro tabulku v Power Apps

  5. Vyberte kartu Události . Zobrazí se obslužné rutiny událostí při uložení i při načtení .

    Snímek obrazovky s kartou Události zobrazující obslužné rutiny událostí formuláře Při uložení a Při načtení

  6. Chcete-li přidat obslužnou rutinu události pro událost změny, vyberte sloupec a pak vyberte kartu Událost .

    Snímek obrazovky s kartou Události ve sloupci s nastavením obslužné rutiny události Při změně

Hromadné úpravy formulářů

Ve výchozím nastavení se obslužné rutiny událostí nespustí, 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 nebo nastavením atributu BehaviorInBulkEditForm na Enabled. V současné době se toto chování 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 určit, kdy obslužná rutina události běží ve formuláři v režimu hromadné úpravy, použijte metodu getFormType .

Přidání nebo odebrání funkcí obslužné rutiny událostí pomocí kódu rozhraní API klienta

Pomocí následujících metod přidejte a odeberte obslužné rutiny událostí pro události, které nemůžete 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é nastavíte pomocí kódu. Další informace najdete v tématu Kontext spuš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í. Oddíl Obslužné rutiny událostí na kartě Události v dialogovém okně Vlastnosti formuláře zobrazuje pořadí obslužných rutin událostí a každá obslužná rutina události se spustí v tomto pořadí.

Pomocí metod setSharedVariable a getSharedVariable předejte společnou proměnnou mezi obslužné rutiny událostí (funkce). Použijte metodu getDepth kontextu provádění, abyste porozuměli posloupnosti provádění obslužné rutiny události vzhledem k jiným obslužným rutině událostí.

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

  • Poslední aktualizace v