共用方式為


模型導向應用程式中表單和方格中的事件

事件會啟動所有用戶端程式碼。 在模型導向應用程式中,您可以將 JavaScript 程式庫 (指令碼 Web 資源) 中的特定函式建立關聯,以便在事件發生時執行。 此函式稱為 事件處理常式。 每個事件處理常式都會指定 JavaScript 程式庫內的單一函式,以及可傳遞給函式的任何參數。

您可以使用 UI 將事件處理常式與某些事件建立關聯。 對於無法透過 UI 關聯的事件,用戶端 API 提供可用來將事件處理常式附加至這類事件的方法。

使用 UI 將事件處理常式函式新增至事件

使用 [表單屬性] 對話方塊的 [事件處理常式] 區段,將您的指令碼與表單和欄的事件建立關聯。

單屬性中的事件處理常式區段。

大量編輯表單

根據預設,當表單處於大量編輯模式時,不會呼叫事件處理常式。

若要在大量編輯模式中啟用事件處理常式,請尋找相關 event 元素,並將屬性建立/設定 BehaviorInBulkEditFormEnabled來修改表單 XML。 目前,這僅支援 OnLoad 事件

如需表單 XML 自訂的詳細資訊,請參閱何時 編輯自訂檔案自訂表單表單 XML 結構描述

若要判斷何時在大量編輯模式的表單上呼叫事件處理常式,請使用 getFormType 方法。

使用程式碼將事件處理常式函式新增至事件

使用下列方法來新增和移除無法透過 UI 關聯之事件的事件處理常式:

活動 事件處理常式
屬性 OnChange addOnChangeremoveOnChange 方法
表單 OnLoad formContext.ui addOnLoadremoveOnLoad 方法
單載入 formContext.ui addLoadedremoveLoaded 方法
表單資料 OnLoad formContext.data addOnLoadremoveOnLoad 方法
表單 OnSave addOnSaveremoveOnSave 方法
查閱控制項 PreSearch addPreSearchremovePreSearch 方法
kbsearch 控制項 OnResultOpened addOnResultOpenedremoveOnResultOpened 方法
kbsearch 控制項 OnSelection addOnSelectionremoveOnSelection 方法
kbsearch 控制項 PostSearch addOnPostSearchremoveOnPostSearch 方法

這很重要

執行內容會自動作為第一個參數傳遞給使用程式碼設定的函數。 其他資訊: 用戶端 API 執行內容

表單事件管線

您最多可以為每個事件定義 50 個事件處理常式。 每個事件處理常式都會依照其在 [表單屬性] 對話方塊的 [事件] 索引標籤的 [事件處理常式] 區段中顯示的順序執行。

使用 setSharedVariablegetSharedVariable 方法,在事件處理常式 (函數) 之間傳遞通用變數。 使用執行環境定義 getDepth 方法來瞭解事件處理程式相對於其他事件處理程式執行的順序。

瞭解用戶端 API 物件模型
用戶端 API 執行內容
事件 (用戶端 API 參考)