ObjectId - 图表函数

ObjectId() 图表函数返回计算表达式的对象的 ID。该函数采用一个可选参数，指定该函数所关注的对象类型。对象可以是工作表或可视化。此函数仅在图表表达式中可用。

语法：

ObjectId([object_type_str])

返回数据类型： string

函数的唯一参数 object_type_str 是可选的，它引用表示对象类型的字符串值。

参数
参数	描述
object_type_str	表示正在计算的对象类型的字符串值。

如果函数表达式中未指定参数，ObjectId() 将返回使用表达式的对象的 ID。要返回显示可视化的图纸对象的 ID，请使用 ObjectId('sheet')。

如果可视化对象嵌套在其他可视化对象中，请在函数参数中为不同的结果指定所需的对象类型。例如，对于容器中的文本和图像图表，使用 'text-image' 返回文本和图像对象，使用 'container' 返回容器的 ID。

执行以下操作：

限制：

当在作为主条目的容器内的对象（例如按钮）中调用此函数时，可能会产生意外的结果。此限制也适用于筛选器窗格主条目，这些主条目是多个列表框的容器。这是因为主条目使用对象层次结构的方式。

在这些情况下，图表表达式 ObjectId('sheet') 将返回一个空字符串，而ObjectId('masterobject') 将显示所属主条目的标识符。

ObjectId() 通常与以下函数结合使用：

相关函数
函数	交互
if - 脚本和图表函数	if 和 ObjectId 函数可以一起用于创建条件表达式。例如，可视化可以通过使用这些函数的表达式实现条件着色。
InObject - 图表函数	与 if 类似，InObject 也与 ObjectId 一起用于创建条件表达式。

示例 1 – 返回图表对象 ID

下面的基本示例演示了如何返回可视化的 ID。

执行以下操作：

文本和图像对象的 ID 显示在可视化中。

使用以下表达式可以获得相同的结果：

=ObjectId('text-image')

下面的基本示例演示如何返回显示可视化的工作表的 ID。

执行以下操作：

工作表的 ID 将显示在可视化中。

以下示例显示了 ObjectId() 函数如何嵌套在其他表达式中。

执行以下操作：

打开新工作表并将文本和图像图表拖到工作表上。
在属性面板中，单击添加度量。
单击以打开表达式编辑器。
将以下表达式粘贴到对话框中：

=if(InObject(ObjectId('text-image')), 'In Text & image', 'Not in Text & image')
单击应用。

In Text & image 文本显示在图表中，表示表达式中引用的对象是文本和图像图表。

有关使用条件着色的更详细示例，请参见InObject - 图表函数

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们如何改进！