此事件发生在业务流程控制更改阶段 之前 。 当用户选择下一阶段、移动到上一阶段或设置用户界面中的活动阶段按钮或开发人员使用formContext.data.process.moveNextformContext.data.process.movePreviousformContext.data.process.setActiveStage或方法时,将发生此事件。
注释
OnPreStageChange 事件仅在统一接口上受支持。
在注册到 onPreStageChange 事件的 Web 资源脚本中,开发人员可以在传递到 Web 资源脚本的 executionContext 对象上调用以下内容:
executionContext.getEventArgs().preventDefault();
调用 preventDefault时:
- 不会处理阶段导航。 进程实例将保留在原始阶段。
- 在跨表导航中,目标阶段表的形式不会打开。
- 不会处理主窗体的保存。 如果主形式处于脏状态,它将保持脏状态。
- 不会调用在StageChange 上注册的任何 Web 资源。
执行上下文对象将传递给此事件的事件处理程序。 可以使用 getEventArgs 方法检索具有以下方法的对象:
-
getDirection:返回一个字符串,表示
Next或Previous显示阶段更改的方向。 - getStage:返回阶段对象。 除了导航移动到新表时,返回的阶段表示目标阶段对象,即下一个活动阶段。 导航移动到新表时,阶段是从中导航的阶段,即上一个活动阶段对象。 详细信息: 暂存方法。
此事件支持的方法
- formContext.data.process。addOnPreStageChange 方法可添加此事件的事件处理程序。
- formContext.data.process。removeOnPreStageChange 方法可删除此事件的事件处理程序。