网格在模型驱动应用中以表格格式显示数据。 网格可以跨越整个窗体,也可以是窗体上的项之一;后者称为 子网格。
网格类型
模型驱动应用中有两种类型的网格:
- 只读网格:以表格格式显示数据。 若要编辑只读网格中显示的数据,必须选择网格中的记录以打开窗体、编辑数据,然后保存。
- 可编辑网格:除了以表格格式显示数据外,还可以在 Web 和移动客户端上提供丰富的内联编辑功能,包括在同一网格中对数据进行分组、排序和筛选的功能,以便无需切换记录或视图。 可编辑网格是自定义控件,在 Web 客户端和仪表板和移动客户端上的窗体网格上支持主网格和子网格。 尽管可编辑网格控件提供编辑功能,但它遵循只读网格元数据和字段级安全设置。
获取网格上下文
网格上下文是要对其运行代码的窗体上的网格或子网格实例。 有关获取网格上下文以执行 JavaScript 代码的详细信息,请参阅 客户端 API 网格上下文
事件
| Name | Description | 适用范围 |
|---|---|---|
| Subgrid OnLoad 事件 | 每次刷新子网格时发生。 这包括当用户通过单击列标题对子网格中的值进行排序时。 | 只读网格 |
| Grid OnChange | 在可编辑网格的单元格中更改值并且单元格失去焦点时发生 | 可编辑网格 |
| Grid OnRecordSelect | 在可编辑网格中选择单个行(记录)时发生 | 可编辑网格 |
| 网格 OnSave | 在将更新的信息发送到服务器之前发生,当发生以下任一情况时发生:记录选择发生更改时,用户使用可编辑网格的保存按钮显式触发保存作,或者用户应用可编辑网格中的排序、筛选、组、分页或导航作,同时存在挂起的更改。 | 可编辑网格 |
注释
可以使用模型驱动应用页的“事件”选项卡注册 OnChange、OnRecordSelect 和 OnSave 事件,该选项卡用于为表或只读网格启用可编辑网格。
对象
使用以下对象与网格交互。 这些对象构成层次结构,如下图所示:
| Name | Description | 适用于 |
|---|---|---|
| GridControl | 提供处理网格或子网格控件的方法。 | 只读和可编辑的网格 |
| 网格 | 提供访问网格中有关数据的信息的方法。 | 只读和可编辑的网格 |
| GridRow | 提供处理网格中的行或选定行的方法。 | 只读和可编辑的网格 |
| GridRowData | 提供处理网格中的行或选定行的方法。 | 只读和可编辑的网格 |
| GridEntity | 提供访问有关行中特定记录的数据的方法。 | 只读和可编辑的网格 |
| GridAttribute | 提供用于访问可编辑网格单元格中的数据的方法。 | 可编辑网格 |
| GridCell | 提供用于访问与表单上的控件相关的数据的方法,该窗体绑定到可编辑网格中的列。 | 可编辑网格 |
| ViewSelector | 提供获取或设置有关子网格控件的视图选择器的信息的方法。 | 只读网格 |