客户端 API 网格上下文可帮助你访问和操作窗体上的网格和子网格中的表格数据。 网格可以跨越整个窗体或显示为称为 子网格的窗体项。
客户端 API 网格上下文提供了对表单上某个子网格的引用,当前代码即在此子网格上执行。
使用 formContext 获取执行代码的窗体的实例,然后检索窗体上的子网格控件。 例如,当你知道子网格控件的名称(例如默认帐户窗体中的 联系人 子网格),可以使用以下代码访问它:
function doSomething(executionContext) {
var formContext = executionContext.getFormContext(); // get the form Context
var gridContext = formContext.getControl("Contacts"); // get the grid context
// Perform operations on the subgrid
}
局限性
- 获取网格上下文(覆盖整个表单)仅在功能区命令中受支持。 有关详细信息,请参阅 功能区操作中的窗体和网格上下文。
- 当您使用
gridContext时,对getControl()的调用不受支持。 - 网格上下文具有与其执行上下文相同的有效性。 执行上下文的事件处理程序执行完毕后,使用这些上下文时需要格外小心。 请参阅 异步使用上下文对象。