方格在模型導向應用程式中以表格格式呈現資料。 方格可以跨越整個表單,也可以是表單上的其中一個項目;後者稱為 子網格。
網格類型
模型導向應用程式中有兩種類型的方格:
- 唯讀方格:以表格式顯示資料。 若要編輯唯讀方格中顯示的資料,您必須選取方格中的記錄以開啟表單、編輯資料,然後儲存。
- 可編輯的網格:除了以表格格式顯示資料外,還在 Web 和行動用戶端上提供豐富的內嵌編輯功能,包括在同一網格內對資料進行分組、排序和篩選的能力,這樣您就不必切換記錄或檢視。 可編輯方格是自訂控制項,在 Web 用戶端的表單上的主要方格和子方格中,以及行動用戶端的儀表板和表單方格上都受支援。 雖然可編輯的網格控制項提供編輯功能,但它會遵循唯讀網格的中繼資料和欄位層級安全性設定。
取得方格內容
方格內容是您要針對其執行程式碼的表單上的方格或子方格執行個體。 如需取得方格內容以執行 JavaScript 程式碼的詳細資訊,請參閱 用戶端 API 方格內容
活動
| 名稱 | Description | 適用於 |
|---|---|---|
| 子網格 OnLoad 事件 | 每次子格重新整理時都會發生。 這包括當使用者透過按一下直欄標題來排序子格中的值時。 | 唯讀方格 |
| 網格變更 | 當可編輯格點中儲存格中的值變更,且儲存格失去焦點時發生 | 可編輯的格線 |
| 格線 OnRecordSelect | 在可編輯格線中選取單一列 (記錄) 時發生 | 可編輯的格線 |
| 網格 OnSave | 在將更新的資訊傳送至伺服器之前,以及發生下列任何情況時發生:記錄選取範圍發生變更、使用者使用可編輯方格的儲存按鈕明確觸發儲存作業,或使用者在有擱置變更時從可編輯方格套用排序、篩選、群組、分頁或導覽作業。 | 可編輯的格線 |
備註
您可以使用模型導向應用程式頁面的事件索引標籤註冊 OnChange、OnRecordSelect 和 OnSave 事件,該索引標籤用於為資料表或唯讀方格啟用可編輯方格。
物件
使用下列物件與格線互動。 這些物件會形成階層,如下圖所示:
| 名稱 | Description | 適用於 |
|---|---|---|
| 網格控制 | 提供使用方格或子方格控制項的方法。 | 唯讀和可編輯的方格 |
| 網格 | 提供存取網格中資料相關資訊的方法。 | 唯讀和可編輯的方格 |
| 網格列 | 提供處理格線中列或選取列的方法。 | 唯讀和可編輯的方格 |
| GridRowData | 提供處理格線中列或選取列的方法。 | 唯讀和可編輯的方格 |
| 網格實體 | 提供存取資料列中特定記錄相關資料的方法。 | 唯讀和可編輯的方格 |
| GridAttribute | 提供存取可編輯格線儲存格中資料的方法。 | 可編輯的格線 |
| 網格單元 | 提供方法來存取與表單控制項相關的資料,這些表單是繫結至可編輯方格中欄的表單。 | 可編輯的格線 |
| ViewSelector | 提供取得或設定子格控制項檢視選取器的相關資訊的方法。 | 唯讀方格 |