事件會啟動所有用戶端程式碼。 在模型導向應用程式中,您可以將 JavaScript 程式庫 (指令碼 Web 資源) 中的特定函式建立關聯,以便在事件發生時執行。 此函式稱為 事件處理常式。 每個事件處理常式都會指定 JavaScript 程式庫內的單一函式,以及可傳遞給函式的任何參數。
您可以使用 UI 將事件處理常式與某些事件建立關聯。 對於無法透過 UI 關聯的事件,用戶端 API 提供可用來將事件處理常式附加至這類事件的方法。
使用 UI 將事件處理常式函式新增至事件
大量編輯表單
根據預設,當表單處於大量編輯模式時,不會呼叫事件處理常式。
若要在大量編輯模式中啟用事件處理常式,請尋找相關 event 元素,並將屬性建立/設定 BehaviorInBulkEditForm 為 Enabled來修改表單 XML。 目前,這僅支援 OnLoad 事件。
如需表單 XML 自訂的詳細資訊,請參閱何時 編輯自訂檔案、 自訂表單和 表單 XML 結構描述。
若要判斷何時在大量編輯模式的表單上呼叫事件處理常式,請使用 getFormType 方法。
使用程式碼將事件處理常式函式新增至事件
使用下列方法來新增和移除無法透過 UI 關聯之事件的事件處理常式:
| 活動 | 事件處理常式 |
|---|---|
| 屬性 OnChange | addOnChange 和 removeOnChange 方法 |
| 表單 OnLoad | formContext.ui addOnLoad 和 removeOnLoad 方法 |
| 表 單載入 | formContext.ui addLoaded 和 removeLoaded 方法 |
| 表單資料 OnLoad | formContext.data addOnLoad 和 removeOnLoad 方法 |
| 表單 OnSave | addOnSave 和 removeOnSave 方法 |
| 查閱控制項 PreSearch | addPreSearch 和 removePreSearch 方法 |
| kbsearch 控制項 OnResultOpened | addOnResultOpened 和 removeOnResultOpened 方法 |
| kbsearch 控制項 OnSelection | addOnSelection 和 removeOnSelection 方法 |
| kbsearch 控制項 PostSearch | addOnPostSearch 和 removeOnPostSearch 方法 |
這很重要
執行內容會自動作為第一個參數傳遞給使用程式碼設定的函數。 其他資訊: 用戶端 API 執行內容
表單事件管線
您最多可以為每個事件定義 50 個事件處理常式。 每個事件處理常式都會依照其在 [表單屬性] 對話方塊的 [事件] 索引標籤的 [事件處理常式] 區段中顯示的順序執行。
使用 setSharedVariable 和 getSharedVariable 方法,在事件處理常式 (函數) 之間傳遞通用變數。 使用執行環境定義 getDepth 方法來瞭解事件處理程式相對於其他事件處理程式執行的順序。
表