Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Zdarzenia inicjują cały kod po stronie klienta. W aplikacjach opartych na modelu należy skojarzyć konkretną funkcję w bibliotece JavaScript (zasób internetowy skryptu) do wykonania w przypadku wystąpienia zdarzenia. 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 są dostępne do skojarzenia 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ń do takich zdarzeń.
Dodawanie lub usuwanie funkcji obsługi zdarzeń do zdarzenia przy użyciu interfejsu użytkownika
Użyj sekcji Procedury obsługi zdarzeń okna dialogowego Właściwości formularza , aby skojarzyć skrypt ze zdarzeniem formularzy i kolumn.
Formularze edycji zbiorczej
Domyślnie programy obsługi zdarzeń nie są wywoływane, 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/ustawiając BehaviorInBulkEditForm atrybut na Enabled. Obecnie jest to 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 wywoływany w formularzu w trybie edycji zbiorczej, użyj getFormType metody .
Dodawanie lub usuwanie funkcji obsługi zdarzeń do zdarzenia przy użyciu kodu
Za pomocą następujących metod można dodawać i usuwać program obsługi zdarzeń dla zdarzeń, które nie mogą być skojarzone 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. Więcej informacji: Kontekst wykonywania interfejsu API klienta
Potok zdarzeń formularza
Dla każdego zdarzenia można zdefiniować maksymalnie 50 procedur obsługi zdarzeń. Każda procedura obsługi zdarzeń jest wykonywana w kolejności wyświetlanej w sekcji Programy obsługi zdarzeń na karcie Zdarzenia okna dialogowego Właściwości formularza .
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 poznać sekwencję wykonywania programu obsługi zdarzeń względem innych procedur obsługi zdarzeń.
Powiązane artykuły
Omówienie modelu obiektów interfejsu API klienta
Kontekst wykonywania interfejsu API klienta
Zdarzenia (dokumentacja interfejsu API klienta)