FieldDisplayNames

将字段的显示名称作为 JSON 数据返回。

格式

FieldDisplayNames ( 文件名称; 文件名称 )

参数

文件名称 - 打开的数据库文件（本地或远程）的名称。请参见设计函数。

文件名称 - 字段名称的文本表达式。要指定存在于不是当前表的其他表中的字段，字段名称必须采用表名称::字段名称形式。

返回的数据类型

文本

原始版本

26.0

说明

返回一个JSON对象，其中包含在“自定义字段显示名称”选项中为指定字段配置的所有显示名称。请参阅定义高级字段选项。

示例 1

FieldDisplayNames ( "" ; "Customers::FirstName" ) 返回当前文件中“Customers”表中“FirstName”字段所配置的所有显示名称。如果默认显示名称和表视图显示名称分别设置为“FirstName”和“Given Name”，则该函数将返回：

{"fm_common":"First Name","fm_table_view":"Given Name"}

示例 2

JSONGetElement ( FieldDisplayNames ( "" ; "Customers::FirstName" ) ; "fm_table_view" ) 返回“Customers”表中“FirstName”字段在表视图中的显示名称，即“}Given Name名”。

示例 3

在布局空间有限的情况下，于布局计算中返回字段标签的自定义显示名称。在“CustomerID”字段的“高级字段选项”对话框中，针对“自定义字段显示名称”，指定一个名为 my_short_name 的自定义键，并将其值设为 ID：

JSONSetElement ( "{}" ; [ "my_short_name" ; "ID" ; JSONString ] )

在字段标签的布局计算中，此计算检索短名称：

JSONGetElement ( FieldDisplayNames ( "" ; "Customers::CustomerID" ) ; "my_short_name" )

这将返回 ID 作为字段标签。