Get 函数

Get 函数监视脚本中的错误，或捕获有关文件状态或要执行的操作的信息。

许多 Get 函数都返回定期更改的信息。例如，将 Get (当前时间) 函数放在已存储的计算字段时，只有当创建新记录时才会更新时间。如果计算包含其他字段，而计算结果仍返回当前时间，那么只有在当前记录中修改那些其他字段时，才会更新已存储的计算结果。如果未存储两个计算结果中的任意一个，那么将根据需要更新时间。出于性能方面的考虑，不存储计算字段未必总是一种最佳方法。Get 函数最好用于脚本，这样即可在运行计算时实时更新 Get 函数提供的状态信息。

单击函数名，以获取详细信息。

此函数	返回
Get ( 帐户扩展权限 )	已启用的扩展权限的关键字列表（基于用于打开文件的帐户）。
Get ( 帐户组名称 )	帐户通过外部服务器或 OAuth 身份提供者验证身份时返回当前帐户的组名。
Get ( 帐户名 )	文件当前用户所使用的经验证的帐户名。
Get ( 帐户权限集名称 )	由用于打开文件的帐户所使用的权限集名称。
Get ( 活动字段内容 )	具有焦点的字段的内容。
Get ( 活动字段名 )	具有焦点的字段的名称。
Get ( 活动字段表名称 )	包含具有焦点的字段的表的名称。
Get ( 活动布局对象名称 )	在计算的当前窗口中具有焦点的布局对象的名称。
Get ( 活动的辅助键 )	一个数字，表示按下的键盘辅助键。
Get ( 活动入口行号 )	一个数字，表示具有焦点的入口行。
Get ( 活动记录数 )	一个数字，表示当前搜索结果中具有焦点的记录数。
Get ( 活动重复项编号 )	一个数字，表示在重复字段中具有焦点的重复项。
Get ( 选择字符数目 )	一个数字，表示所选字符个数。
Get ( 所选文本的开始字符位置 )	一个数字，表示所选文本的开始字符。
Get ( 允许终止状态 )	如果“允许用户异常中断”脚本步骤已打开，则返回“ 1 ”(true)；否则返回“ 0 ”(false)。
Get ( 允许格式栏状态 )	如果允许格式栏可见，则返回“ 1 ”(true)；否则返回“ 0 ”(false)。
Get ( 应用程序架构 )	当前应用程序结构。
Get ( 应用程序语言 )	表示当前应用程序语言的文本。
Get ( 应用程序版本 )	FileMaker 客户端的产品名和版本。
Get ( 参与计算的复合字段值序号 )	一个数字，表示要计算的计算字段的重复项。
Get ( 连接属性 )	当前文件的主机名和颁发用于保护连接的 SSL 证书的认证中心的名称。
Get ( 连接状态 )	一个数字，表示当前文件的网络连接的安全状态。
Get ( 当前日期 )	当前日期，取决于系统日历。
Get ( 当前扩展权限 )	已启用的扩展权限的关键字列表（基于用于解析此计算的帐户）。
Get ( 当前主机时间戳 )	主机的当前日期和时间（精确到秒），取决于系统时钟。
Get ( 当前权限集名称 )	文件中要用于解析此计算的权限集的名称。
Get ( 当前时间 )	当前时间（精确到秒），取决于系统时钟。
Get ( 当前系统时间 )	当前日期和时间（精确到秒），取决于系统时钟。
Get ( 当前时间UTC毫秒 )	当前时间（世界通用时间 (UTC)，精确到毫秒）。
Get ( 自定义菜单集名称 )	活动自定义菜单集的名称。
Get ( 桌面路径 )	当前用户的桌面文件夹路径。
Get ( 设备 )	一个数值，表示当前运行 Filemaker 产品的电脑或移动设备的类型。
Get ( 文档路径 )	当前用户的 Documents 文件夹路径。
Get ( 文档路径列表 )	Get (文档路径) 函数返回的 Documents 文件夹中的所有文件和文件夹的列表。
Get ( 加密状态 )	一个值，表示文件的当前加密状态。
Get ( 错误捕获状态 )	如果“设置错误捕获”脚本步骤已打开，则返回“ 1 ”(true)；否则返回“ 0 ”(false)。
Get ( FileMaker 路径 )	返回当前运行的 FileMaker 产品副本所在的文件夹路径。
Get ( 文件名 )	当前活动文件的名称（不包括文件扩展名）。
Get ( 文件路径 )	当前活动文件位置的完整路径。
Get ( 文件大小 )	当前活动文件的大小（以字节为单位）。
Get ( 查找个数 )	当前搜索结果中的记录数。
Get ( 高对比度色彩模式 )	当前高对比度默认色彩模式名称。
Get ( 高对比度状态 )	如果高对比度可用且处于活动状态，则返回“ 1 ”(true)；否则返回“ 0 ”(false)。
Get ( 主机应用程序版本 )	FileMaker 主机的产品名和版本。
Get ( 主机 IP 地址 )	当前文件的主机 IP 地址。
Get ( 主机名 )	正在托管文件的计算机的注册名称。
Get ( InstalledFMPlugins )	已安装的插件的名称、版本号和启用状态。
Get ( 上一个错误 )	一个数字，表示在最近执行的脚本步骤的执行中出现的错误。
Get ( 上一个外部错误详情 )	Get (上一个错误) 返回的 FileMaker 外部错误的相关文本。
Get ( 上次选择信息 )	一个数字，对应于在“显示自定义对话框”脚本步骤显示的警报信息中所点按的按钮。
Get ( 布局访问权限 )	一个数字，基于在当前布局中可用的记录访问权限。
Get ( 布局个数 )	文件中的布局总数。
Get ( 布局名称 )	当前显示的布局的名称。
Get ( 布局编号 )	当前显示的布局的编号（在“管理布局”对话框中指定）。
Get ( 布局表名称 )	在当前布局中显示记录的表的名称。
Get ( 布局浏览模式 )	一个数字，表示当前活动的文件视图。
Get ( 菜单栏状态 )	一个数字，表示当前菜单栏状态。
Get ( 修改的字段 )	已在当前表的当前记录中修改的字段列表。
Get ( 多用户状态 )	一个数字，表示使用 FileMaker 网络的文件的共享级别。
Get ( 网络协议 )	FileMaker 正在此计算机上使用的网络协议 (TCP/IP) 的名称。
Get ( 网络类型 )	一个数字，表示用于访问当前文件的网络的类型。
Get ( 页码 )	一个数字，表示正在打印或预览的当前页面。
Get ( 固定ID )	表示运行 FileMaker 的计算机或设备的唯一标识符的文本。
Get ( 参数路径 )	当前用户的首选项和默认选项文件夹的路径。
Get ( 打印机名称 )	标识默认的打印机名称的文本。
Get ( 快速查找文本 )	在“快速查找”框中输入的文本。
Get ( 记录访问权限 )	一个数字，表示通过“自定义记录权限”对话框指定的当前记录的访问权限。
Get ( 记录标识 )	当前记录的唯一 ID 号。
Get ( 记录修改次数 )	已提交的、对当前记录所做更改的总数。
Get ( 记录编号 )	一个数字，表示当前搜索结果中记录的位置。
Get ( 打开记录的个数 )	在尚未保存的当前搜索结果中已打开的记录的总数。
Get ( 打开记录的状态 )	一个数字，表示当前记录的状态。
Get ( 区域监视事件 )	一些事件，这些事件导致“配置区域监视脚本”脚本步骤中的脚本运行。
Get ( 请求个数 )	为当前表定义的查找请求的总数。
Get ( 请求忽略状态 )	如果在当前查找请求中选择了“省略”，则返回“ 1 ”(true)；否则返回“ 0 ”(false)。
Get ( 屏幕色度 )	显示主屏幕像素颜色或灰度所需的位数。
Get ( 屏幕高度 )	在其中打开了当前文件窗口的屏幕的高度（以磅为单位）。
Get ( 屏幕缩放系数 )	在其中打开当前文件的屏幕的缩放系数。
Get ( 屏幕宽度 )	在其中打开了当前文件窗口的屏幕的宽度（以磅为单位）。
Get ( 脚本动画状态 )	如果为当前脚本启用了动画，则返回“ 1 ”(true)；否则返回“ 0 ”(false)。
Get ( 脚本名称 )	当前运行或暂停的脚本的名称。
Get ( 脚本参数 )	传递到当前脚本的脚本参数。
Get ( 脚本结果 )	来自已执行子脚本的脚本结果。
Get ( 排序状态 )	一个值，表示当前排序状态。
Get ( 状态区域状态 )	一个数字，表示当前状态工具栏的状态。
Get ( 系统驱动器 )	正在运行的操作系统所在的驱动器号（对于 Windows）或卷名称（对于 macOS）。
Get ( 系统 IP 地址 )	连接到活动 NIC（网络接口控制器）卡的所有计算机的 IP 地址列表。
Get ( 系统语言 )	当前系统上所设置的语言。
Get ( 系统网络硬件地址 )	连接到计算机的所有 NIC（网络接口控制器）卡的硬件地址。
Get ( 系统平台 )	一个数字，表示当前平台。
Get ( 系统版本 )	当前操作系统的版本。
Get ( 临时路径 )	返回当前 FileMaker 临时文件夹的路径。
Get ( 标尺可见状态 )	如果显示文本标尺，则返回“ 1 ”(true)；否则返回“ 0 ”(false)。
Get ( 总记录数 )	当前表中的记录总数。
Get ( 触控键盘状态 )	如果触控键盘设置为在需要时自动显示，则返回“ 1 ”(true)；否则返回“ 0 ”(false)。
Get ( 触发当前面板 )	在激活 OnPanelSwitch 脚本触发器时自其进行切换的面板的索引和对象名称。
Get ( 触发外部事件 )	一个数字，表示激活 OnExternalCommandReceived 脚本触发器的事件。
Get ( 触发手势信息 )	有关激活 OnGestureTap 脚本触发器的手势的详细信息。
Get ( 触发击键 )	激活 OnObjectKeystroke 脚本触发器或 OnLayoutKeystroke 脚本触发器的字符。
Get ( 触发辅助键 )	激活 OnObjectKeystroke 脚本触发器或 OnLayoutKeystroke 脚本触发器时键盘辅助键的状态。
Get ( 触发目标面板 )	在激活 OnPanelSwitch 脚本触发器时切换到的面板的索引和对象名称。
Get ( 用户个数 )	当前正在访问文件的客户端个数。
Get ( 用户名 )	FileMaker 用户的名称，它是在“首选项”对话框的“ 常规 ”选项卡中指定的。
Get ( 系统格式状态 )	如果“格式”菜单中的“使用系统格式”已打开，则返回“ 1 ”(true)；否则返回“ 0 ”(false)。
Get ( UUID )	表示通用唯一标识符 (UUID) 的文本。
Get ( UUID 号 )	表示通用唯一标识符 (UUID) 值的数字。
Get ( 工作区高度 )	窗口内容区域的高度（以磅为单位）。
Get ( 工作区宽度 )	窗口内容区域的宽度（以磅为单位）。
Get ( 窗口桌面高度 )	桌面空间的高度（以磅为单位）。
Get ( 窗口桌面宽度 )	桌面空间的宽度（以磅为单位）。
Get ( 窗口高度 )	正在操作脚本的窗口的高度（以磅为单位）。
Get ( 窗口左边距 )	正在操作脚本的窗口的外部边缘相对于屏幕最左边缘的水平距离（以磅为单位）。
Get ( 窗口模式 )	一个数字，表示在解析函数时 FileMaker 产品的模式。
Get ( 窗口名称 )	正在操作脚本的窗口的名称。
Get ( 窗口方向 )	一个值，表示正在操作脚本的窗口的方向。
Get ( 窗口样式 )	正在操作脚本的窗口的样式。
Get ( 窗口上边距 )	正在操作脚本的窗口的外部边缘相对于菜单栏底部边缘 (macOS) 或屏幕顶部边缘 (Windows) 的垂直距离（以磅为单位）。
Get ( 窗口是否可见 )	如果窗口可见，则返回“ 1 ”(true)；如果使用“隐藏窗口”隐藏了窗口，则返回“ 0 ”(false)。
Get ( 窗口宽度 )	正在操作脚本的窗口的宽度（以磅为单位）。
Get ( 窗口缩放级别 )	当前窗口的缩放百分比。

示例 1

此脚本使用 Get (当前日期) 函数检查搜索结果中的每条记录以确定是否存在过期的帐户。如果某个帐户已经过期，则该脚本显示一条消息并提示用户单击标有“省略”、“发送信函”或“发送邮件”（通过“显示自定义对话框”脚本步骤进行设置）的按钮。该脚本使用 Get (上次选择信息) 函数捕获用户的响应。然后，根据用户的响应，脚本执行操作：取消脚本的其余部分、打印“付费已晚”信函或向关联帐户发送电子邮件。


   转到布局 ["布局名称"]
   

   转到记录/请求/页面 [第一个]
   

   Loop
   

   If [数据库名称::日期 < Get (当前日期) - 30]
   

   显示自定义对话框 ["最近 30 天或更多天"]
   

   If [Get (上次选择信息) = 1]
   

   中断脚本
   

   Else If [Get (上次选择信息) = 2]
   

   转到布局 ["过期提醒"]
   

   打印 []
   

   Else
   

   发送邮件 [通过电子邮件客户端发送; 包括对话框: 关闭; 收件人: 数据库名称::客户; 主题: "过期提醒"; 消息: "您的帐户已过期。"]
   

   End If
   

   End If
   

   转到记录/请求/页面 [下一步; 最后一步后退出: 打开]
   

   End Loop
   

   转到布局 [原始布局]

Get 函数

示例 1

相关主题