设置脚本触发器
可以设置脚本触发器来指定事件发生时运行脚本。例如,可以使用脚本触发器运行一个脚本,根据另一个字段中输入的内容在字段中自动输入数据。
有些脚本触发器会在数据库引擎处理某个事件之前运行脚本。其他脚本触发器会在数据库引擎处理某个事件之后运行脚本。例如,可以使用 OnObjectEnter 脚本触发器在输入一个字段之后运行脚本。(此字段为对象;输入此字段为一个事件。)
脚本触发器可以通过用户操作或脚本来激活。例如,可以使用 OnObjectEnter 脚本触发器激活一个脚本,从而使该脚本在用户单击字段或执行“转至对象”脚本步骤来输入字段时运行。
可以设置脚本触发器在以下情况下激活:
-
用户输入特定布局时。请参阅设置布局的脚本触发器。
-
用户输入、修改或退出布局上一个或多个对象时。请参阅设置对象的脚本触发器。
-
打开或关闭文件时,或媒体文件的回放状态发生变化时。有关如何执行此操作的信息,请参阅设置文件选项。
要查看为哪些布局对象和布局指定了脚本触发器,请在布局模式下,选择“查看”菜单 >“显示”>“脚本触发器”。
有下列脚本触发器可用:
触发器区域 | 脚本触发器 | 处理之前 | 处理之后 |
---|---|---|---|
对象 |
|
X |
|
X |
|
||
|
X |
||
X |
|
||
|
X |
||
X |
|
||
X |
|
||
|
X |
||
布局 |
|
X |
|
X |
|
||
X |
|
||
X |
|
||
|
X |
||
X |
|
||
|
X |
||
|
X |
||
X |
|
||
|
X |
||
X |
|
||
|
X |
||
文件选项 |
|
X |
|
X |
|
||
|
X |
||
X |
|
||
|
X |
||
|
X |
脚本触发器的时间顺序
当同一个事件激活多个脚本触发器时,脚本触发器会按照以下相应顺序执行:
-
OnFirstWindowOpen
-
OnWindowOpen
-
OnLayoutEnter
-
OnModeEnter
-
OnRecordLoad
-
OnLayoutSizeChange
-
OnViewChange
以下脚本触发器的顺序由触发事件控制:
-
OnObjectEnter
-
OnObjectKeystroke
-
OnLayoutKeystroke
-
OnGestureTap
-
OnObjectAVPlayerChange
-
OnFileAVPlayerChange
-
OnExternalCommandReceived
-
OnPanelSwitch
-
OnObjectModify
-
OnObjectValidate
-
OnObjectSave
-
OnObjectExit
-
OnRecordCommit 或 OnRecordRevert
-
OnWindowTransaction
-
OnModeExit
-
OnLayoutExit
-
OnWindowClose
-
OnLastWindowClose
注释
-
脚本触发器运行的脚本使用现有权限。除非将脚本定义为以完全权限运行,否则脚本将使用用户的权限运行。
-
在“自定义 Web 发布”和 FileMaker Data API 下,脚本触发器只能由脚本激活,而不能由直接的用户交互激活。由于“自定义 Web 发布”和 FileMaker Data API 未通过 FileMaker 用户界面访问数据,因此用户无法直接激活脚本触发器。但如果脚本步骤导致焦点移动到该字段中,则将激活该脚本触发器。
-
某些脚本触发器允许在脚本触发器运行的脚本返回值 False 的情况下,取消触发事件。如果以这种方式取消命令或事件,错误代码将设置为 20。有关更多信息,请参阅 Get (上一个错误)函数。如果 OnLastWindowClose 脚本触发器运行的脚本返回值 False,则文件将不关闭。
-
Windows:Alt 和 Ctrl 组合键不会激活脚本触发器。
-
macOS:Command 组合键不会激活脚本触发器。