模型驱动应用中窗体和网格中的事件

窗体和网格中的事件在模型驱动应用中启动所有客户端代码。 将 JavaScript 库中的特定函数(脚本 Web 资源)关联在事件发生时要执行的函数。 此函数称为 事件处理程序。 每个事件处理程序指定 JavaScript 库中的单个函数以及可传递给函数的任何参数。

可以使用 UI 将事件处理程序关联到仅某些事件。 对于无法通过 UI 关联的事件,客户端 API 提供了可用于附加事件处理程序的方法。

使用 UI 在窗体中添加或删除事件处理程序函数

若要在新的统一接口中添加或删除事件的事件处理程序函数,请执行以下操作:

  1. 转到 Power Apps。

  2. 在左侧导航窗格中,选择 “数据 ”,然后选择“ 表”。

  3. 从表列表中,选择要在其中添加事件处理程序的表。

  4. 从命令栏中选择 “窗体 ”选项卡,然后选择要在其中添加事件处理程序的窗体。

    “窗体”选项卡的屏幕截图,其中显示了Power Apps中表的窗体列表。

  5. 选择“ 事件 ”选项卡。可以看到 On Save 和 On Load 事件处理程序。

    “事件”选项卡的屏幕截图,其中显示了“保存时”和“加载时”窗体事件处理程序。

  6. 若要为更改事件添加事件处理程序,请选择该列,然后选择 “事件 ”选项卡。

    “事件”选项卡的屏幕截图,其中显示了“更改时”事件处理程序设置。

批量编辑表单

默认情况下,当窗体处于批量编辑模式时,事件处理程序不会运行。

若要在批量编辑模式下启用事件处理程序,请通过查找相关元素并将属性设置为 <a0/> 来修改 Form XML。 目前,仅 OnLoad 事件支持此行为。

有关表单 XML 自定义的详细信息,请参阅 何时编辑自定义项文件、 自定义窗体和 窗体 XML 架构。

若要确定事件处理程序何时在批量编辑模式下在窗体上运行,请使用 getFormType 该方法。

使用客户端 API 代码添加或删除事件处理程序函数

使用以下方法为无法通过 UI 关联的事件添加和删除事件处理程序:

事件 事件处理程序
Attribute OnChange addOnChange 和 removeOnChange 方法
Form OnLoad formContext.ui addOnLoad 和 removeOnLoad 方法
已加载窗体 formContext.ui addLoaded 和 removeLoaded 方法
表单数据 OnLoad formContext.data addOnLoad 和 removeOnLoad 方法
窗体 OnSave addOnSave 和 removeOnSave 方法
查找控件 PreSearch addPreSearch 和 removePreSearch 方法
kbsearch 控件 OnResultOpened addOnResultOpened 和 removeOnResultOpened 方法
kbsearch 控件 OnSelection addOnSelection 和 removeOnSelection 方法
kbsearch 控件 PostSearch addOnPostSearch 和 removeOnPostSearch 方法

重要

执行上下文会自动作为第一个参数传递给使用代码设置的函数。 有关详细信息,请参阅 客户端 API 执行上下文。

表单事件管道

最多可为每个事件定义 50 个事件处理程序。 “窗体属性”对话框的“事件”选项卡中的“事件处理程序”部分显示事件处理程序的顺序,每个事件处理程序按该顺序运行。

使用 setSharedVariable 和 getSharedVariable 方法在事件处理程序(函数)之间传递公共变量。 使用执行上下文 getDepth 方法了解相对于其他事件处理程序的事件处理程序执行顺序。

了解客户端 API 对象模型
客户端 API 执行上下文
事件(客户端 API 参考)