在运行时更改自定义属性的表达式或引用

通过使用客户端脚本在图形上调用 SetCustomPropertyValue() 方法，您可以在运行时更改自定义属性的表达式或引用：

SetCustomPropertyValue(System.String name, System.String value, System.Boolean isConstant);

您可以使用元素浏览器，从“工业图形编辑器”选择此方法。

此方法有三个参数：

• name - 要在图形上修改的自定义属性的名称。此参数属于字符串类型，可以是一个引用或一个常量。

• value - 要设置的新值。此参数属于字符串类型，可以是一个表达式、一个引用或一个常量。如果该值括在引号 (") 中，则将其视为一个常量。如果该值不带引号，则表达式的值被视为一个引用。

• isConstant - 一个标帜，指示新值是被评估为一个常量还是一个引用。此参数属于布尔型。如果此参数设置为 True (1)，则新值将被视为一个常量。如果此参数设置为 False (0)，则新值将被视为一个引用。仅当 value 参数是引用或常量，并且 name 参数中指定的自定义属性为字符串或时间类型时，此参数才适用。如果自定义属性为整型、浮点型、布尔型或双精度类型，则此参数无意义。

  注意：isConstant 参数不会覆盖 value 参数的输入类型。根据是否括在引号中，value 参数本身可以是常量或引用。isConstant 参数仅确定如何求出实际值（来自 value 参数）。

自定义属性的整个表达式或引用将替换为新值，而不管是否被覆盖。不支持部分替换。

只能更改图形上的公共自定义属性。

在方法执行时，它会覆盖自带 InTouch 脚本中的先前 IOSetRemoteReference() 调用进行的所有修改。

有关将自定义属性配置为引用的示例，假设您有一个 Motor_001 对象，该对象具有名为 State 的字符串型属性，用于存储马达的当前状态（“Running”或“Stopped”）。您还有一个工业图形，它具有字符串数据类型的自定义属性“MotorState”。以下脚本代码将在运行时把 MotorState 自定义属性设置为 Motor_001.State：

GraphicA.SetCustomPropertyValue("MotorState","Motor_001.State",False);

作为调用的结果，该函数将把字符串型自定义属性 GraphicA.MotorState 作为一个引用设置为“Motor_001.State”。字符串型自定义属性 GraphicA.MotorStatus 将解析该引用，并用引用值（“Running”或“Stopped”）更新其值。

例如将自定义属性配置为常量，假设您有一个 Motor_001 对象，该对象具有布尔型属性名称“State”，用于反映马达的当前状态（True 或 False）。您还有一个工业图形，它具有字符串数据类型的自定义属性“MotorState”。以下脚本代码根据为 Motor_001 返回的值，将 MotorState 自定义属性设置为包含文本格式的设备状态 —“Running”或“Stopped”：

IF Motor_001.State THEN

GraphicA.SetCustomPropertyValue("MotorState","Running",True);

ELSE

GraphicA.SetCustomPropertyValue("MotorState","Stopped",True);

ENDIF;

作为调用的结果，该函数将根据 Motor_001.State 的值，把字符串型自定义属性 GraphicA.MotorState 设置为“Running”或“Stopped”。