Zdarzenia w formularzach i siatkach w aplikacjach opartych na modelu

Zdarzenia w formularzach i siatkach inicjują cały kod po stronie klienta w aplikacjach opartych na modelu. Po wystąpieniu zdarzenia skojarzysz określoną funkcję w bibliotece Języka JavaScript (zasób internetowy skryptu). Ta funkcja jest nazywana procedurą obsługi zdarzeń. Każda procedura obsługi zdarzeń określa jedną funkcję w bibliotece Języka JavaScript i wszystkie parametry, które można przekazać do funkcji.

Programy obsługi zdarzeń można skojarzyć tylko z niektórymi zdarzeniami przy użyciu interfejsu użytkownika. W przypadku zdarzeń, które nie można skojarzyć za pośrednictwem interfejsu użytkownika, interfejs API klienta udostępnia metody, których można użyć do dołączania programów obsługi zdarzeń.

Dodawanie lub usuwanie funkcji obsługi zdarzeń w formularzach przy użyciu interfejsu użytkownika

Aby dodać lub usunąć funkcje obsługi zdarzeń dla zdarzeń w nowym ujednoliconym interfejsie:

  1. Przejdź do Power Apps.

  2. W okienku nawigacji po lewej stronie wybierz pozycję Dane , a następnie wybierz pozycję Tabele.

  3. Z listy tabel wybierz tabelę, w której chcesz dodać programy obsługi zdarzeń.

  4. Wybierz kartę Formularze na pasku poleceń, a następnie wybierz formularz, w którym chcesz dodać procedurę obsługi zdarzeń.

    Zrzut ekranu przedstawiający kartę Formularze z listą formularzy dla tabeli w Power Apps.

  5. Wybierz kartę Zdarzenia . Zobaczysz programy obsługi zdarzeń Przy zapisywaniu i ładowaniu .

    Zrzut ekranu przedstawiający kartę Zdarzenia z procedurami obsługi zdarzeń Formularz zapisywania i ładowania.

  6. Aby dodać procedurę obsługi zdarzeń dla zdarzenia zmiany, wybierz kolumnę, a następnie wybierz kartę Zdarzenie .

    Zrzut ekranu przedstawiający kartę Zdarzenia kolumny z ustawieniami programu obsługi zdarzeń Przy zmianie.

Formularze edycji zbiorczej

Domyślnie programy obsługi zdarzeń nie są uruchamiane, gdy formularz jest w trybie edycji zbiorczej.

Aby włączyć procedurę obsługi zdarzeń w trybie edycji zbiorczej, zmodyfikuj kod XML formularza, wyszukując odpowiedni event element i tworząc lub ustawiając BehaviorInBulkEditForm atrybut na Enabled. Obecnie to zachowanie jest obsługiwane tylko w przypadku zdarzeń OnLoad.

Aby uzyskać więcej informacji na temat dostosowywania formatu XML formularza, zobacz Kiedy edytować plik dostosowywania, Dostosowywanie formularzy i Schemat XML formularza.

Aby określić, kiedy program obsługi zdarzeń jest uruchamiany w formularzu w trybie edycji zbiorczej, użyj getFormType metody .

Dodawanie lub usuwanie funkcji obsługi zdarzeń przy użyciu kodu interfejsu API klienta

Użyj następujących metod, aby dodać i usunąć programy obsługi zdarzeń dla zdarzeń, których nie można skojarzyć za pośrednictwem interfejsu użytkownika:

Events Procedura obsługi zdarzeń
Atrybut OnChange addOnChange i removeOnChange , metody
Załaduj formularz formContext.ui addOnLoad i removeOnLoad metody
Załadowany formularz formContext.ui addLoaded i removeLoaded metod
Ładowanie danych formularza formContext.data addOnLoad i removeOnLoad , metody
Formularz wł. addOnSave i removeOnSave , metody
Wyszukiwanie kontrolki PreSearch addPreSearch i removePreSearch , metody
Kbsearch, kontrolka OnResultOpened addOnResultOpened i removeOnResultOpened metod
Kbsearch, kontrolka OnSelection addOnSelection i removeOnSelection , metody
Kbsearch, kontrolka PostSearch addOnPostSearch i removeOnPostSearch , metody

Ważne

Kontekst wykonywania jest automatycznie przekazywany jako pierwszy parametr do funkcji ustawionych przy użyciu kodu. Aby uzyskać więcej informacji, zobacz Kontekst wykonywania interfejsu API klienta.

Potok zdarzeń formularza

Dla każdego zdarzenia można zdefiniować maksymalnie 50 procedur obsługi zdarzeń. Sekcja Programy obsługi zdarzeń na karcie Zdarzenia okna dialogowego Właściwości formularza zawiera kolejność programów obsługi zdarzeń, a każda procedura obsługi zdarzeń jest uruchamiana w tej kolejności.

Użyj metod setSharedVariable i getSharedVariable, aby przekazać wspólną zmienną między procedurami obsługi zdarzeń (funkcje). Użyj metody getDepth kontekstu wykonywania, aby zrozumieć sekwencję wykonywania procedury obsługi zdarzeń względem innych programów obsługi zdarzeń.

Omówienie modelu obiektów interfejsu API klienta
Kontekst wykonywania interfejsu API klienta
Zdarzenia (dokumentacja interfejsu API klienta)

  • Ostatnia aktualizacja o