模型驱动应用中的网格和子网格(客户端 API 参考)

网格在模型驱动应用中以表格格式显示数据。 网格可以跨越整个窗体,也可以是窗体上的项之一;后者称为 子网格

网格类型

模型驱动应用中有两种类型的网格:

  • 只读网格:以表格格式显示数据。 若要编辑只读网格中显示的数据,必须选择网格中的记录以打开窗体、编辑数据,然后保存。
  • 可编辑网格:除了以表格格式显示数据外,还可以在 Web 和移动客户端上提供丰富的内联编辑功能,包括在同一网格中对数据进行分组、排序和筛选的功能,以便无需切换记录或视图。 可编辑网格是自定义控件,在 Web 客户端和仪表板和移动客户端上的窗体网格上支持主网格和子网格。 尽管可编辑网格控件提供编辑功能,但它遵循只读网格元数据和字段级安全设置。

获取网格上下文

网格上下文是要对其运行代码的窗体上的网格或子网格实例。 有关获取网格上下文以执行 JavaScript 代码的详细信息,请参阅 客户端 API 网格上下文

事件

Name Description 适用范围
Subgrid OnLoad 事件 每次刷新子网格时发生。 这包括当用户通过单击列标题对子网格中的值进行排序时。 只读网格
Grid OnChange 在可编辑网格的单元格中更改值并且单元格失去焦点时发生 可编辑网格
Grid OnRecordSelect 在可编辑网格中选择单个行(记录)时发生 可编辑网格
网格 OnSave 在将更新的信息发送到服务器之前发生,当发生以下任一情况时发生:记录选择发生更改时,用户使用可编辑网格的保存按钮显式触发保存作,或者用户应用可编辑网格中的排序、筛选、组、分页或导航作,同时存在挂起的更改。 可编辑网格

注释

可以使用模型驱动应用页的“事件”选项卡注册 OnChangeOnRecordSelectOnSave 事件,该选项卡用于为表或只读网格启用可编辑网格。

对象

使用以下对象与网格交互。 这些对象构成层次结构,如下图所示:

网格中可用的对象的层次结构

Name Description 适用于
GridControl 提供处理网格或子网格控件的方法。 只读和可编辑的网格
网格 提供访问网格中有关数据的信息的方法。 只读和可编辑的网格
GridRow 提供处理网格中的行或选定行的方法。 只读和可编辑的网格
GridRowData 提供处理网格中的行或选定行的方法。 只读和可编辑的网格
GridEntity 提供访问有关行中特定记录的数据的方法。 只读和可编辑的网格
GridAttribute 提供用于访问可编辑网格单元格中的数据的方法。 可编辑网格
GridCell 提供用于访问与表单上的控件相关的数据的方法,该窗体绑定到可编辑网格中的列。 可编辑网格
ViewSelector 提供获取或设置有关子网格控件的视图选择器的信息的方法。 只读网格

客户端 API 网格上下文
使用可编辑网格
模型驱动应用的客户端 API 参考
模型驱动应用开发人员概述