主页 > 参考 > 函数参考 > 获取函数

获取函数

在脚本中使用获取函数进行错误检查和预防，或者捕获有关数据库文件或其中元素或者所执行操作的状态信息。

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

要访问获取函数列表，请在“指定计算方式”对话框中选择“查看所有函数(按类型)”或“查看获取函数”。当您选择“查看所有函数(按名称)”时，只会看到 Get(标记)。

注释  有关主机和客户端上函数的解析方式不同之处的信息，请搜索 http://help.filemaker.com 中的 FileMaker 知识库。

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

 

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

获取函数示例

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

 

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

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

Loop

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

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

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

      中断脚本

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

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

      打印 []

    Else

      发送邮件 [收件人:数据库名称::客户; 主题:"过期提醒"; 消息:"您的帐户已过期。"]

    End If

  End If

  转到记录/请求/页面 [最后一步后退出, 下一步]

End Loop

转到布局 [原始布局]

相关主题 

关于函数

关于公式