SignedWrite()

属性

这是要更新的属性的名称，也是字符串数据类型。

可以是常量字符串、引用或表达式。

支持绑定和嵌入绑定引用。

如需有关 Attribute 参数使用示例的详细信息，请参阅《创建与管理工业图形用户指南》中“管理图形”下的在 SignedWrite() 函数中使用属性参数的示例主题。

示例 1：

"UserDefined_001.temp"

示例 2：

"Pump15" + ".valve4"

示例 3：

如果 UDO_7 包含两个字符串属性，而 namestrA 和 namestrB 分别设置为值“Tank1”和“Tank5”，则下面的脚本会根据 strselect是“A”还是“B”来写入到 Tank1.Level 或 Tank5.Level：

Dim strselect As String;

Dim x As Indirect;

{ logic to set strselect to "A" or "B" }

x.BindTo ("UDO_7.namestr" + strselect);

SignedWrite(x + ".Level", 243, "Set " + x + " Level", true, 0, null);

值

这是要写入的值。数据类型为对象。值的有效范围必须与要更新的属性的数据类型相匹配。

值可以是常量值、引用、表达式，如果未输入任何内容，则为 NULL。

ReasonDescription

此为文本，说明了目标属性的用途以及更改该属性所带来的影响。

数据类型为字符串，最大长度为 256 个字符。可以是常量字符串、引用或表达式。

作为写入操作的一部分，将 ReasonDescription 传递到指明的属性。该对象还包含用户的写入注释（如果有的话）。如果该属性是字段属性并且有描述（不为空），则字段属性描述仅用于 ReasonDescription 参数。否则，会将相应 ApplicationObject 的简短描述用于 ReasonDescription 参数。

Comment_is _Editable

此参数指示用户能否编辑写入注释。

数据类型为布尔值。

如果设置为 True：发生异常时会启用注释文本框。

• 如果 Comment_Is_Editable 为 true 并且 Comment_ Enforcement 参数为 PredefinedOnly，则会禁用注释文本框。在运行时，用户只能从预定义的注释列表中选择注释。

• 如果 Comment_ Enforcement 参数不是 PredefinedOnly，则会启用注释列表和框。可以从注释列表中选择注释，并在注释框中修改注释。

• 如果预定义列表为空，则对话框中不会显示注释列表。

  如果设置为 False：预定义的注释列表不会显示在“安全写入”或“验证写入”对话框中。禁用可编辑的注释文本框。

Comment_Enforcement

此参数的数据类型为枚举，并具有以下值选项：

0 = Optional
运行时用户可以输入注释或留空。

1 = Mandatory
运行时用户必须添加注释，方式可以是从注释列表中选择或者在注释框中输入注释。

2 = PredefinedOnly
运行时用户只能从注释列表中选择注释。禁用注释文本框。

Predefined_Comment_List

可用于预定义注释的字符串数组。

数据类型为字符串。最多允许 20 个注释，每个注释最多不超过 200 个字符。

• 数组可为空（元素数为 0）。

• 可以是常量、引用、表达式，如果为空，则为 NULL。可以引用包含字符串数组的属性。

• 如果未输入任何预定义的注释，则会在运行时禁用预定义注释列表。

• 如果 Comment_Is_Editable 为 False，则预定义的注释仍在可编辑注释文本框中，但用户无法在运行时对其进行修改。