指定图形的自定义属性值
- Last UpdatedApr 24, 2026
- 1 minute read
图形的自定义属性可以在由包含 CustomProperties 属性的 ShowGraphic() 显示图形时设置为值。
CustomProperties 的参数是自定义属性名称、指定的值和 IsConstant 布尔值标帜,该标帜指出自定义属性值是否为常量。GraphicInfo 中任何具有缺省值的参数都是可选的。如果这些参数没有指定输入值,则会在运行时使用缺省值。除了枚举数据类型以外的任何参数都可以为常量、引用或表达式。使用对象浏览器选择对象并将其自动插入到脚本中时,脚本编辑器会在对象名两边添加双引号。如果您要手动添加对象名,请务必用双引号将其括住。
这些参数通过 CustomPropertyValuePair[] 数组被指定为一系列值。数组索引从 1 开始。
使用 CustomPropertyValuePair[] 数组将属性名指定给自定义属性时,如果未将属性名括在双引号内,则该属性的质量不会被该自定义属性获得。
使用与以下脚本类似的脚本将值指定给图形的自定义属性。在本例中,“i1”是字符串 Identity,而图形“S1”包含自定义属性 CP1 和 CP2。S1 在运行时显示时,为 CP1 指定常量值 20,为 CP2 指定引用 Pump.PV.Tagname 的当前值。
Dim graphicInfo as aaGraphic.GraphicInfo;
Dim cpValues [2] as aaGraphic.CustomPropertyValuePair;
cpValues[1] = new
aaGraphic.CustomPropertyValuePair("CP1", 20, true);
cpValues[2] = new
aaGraphic.CustomPropertyValuePair("CP2", "Pump.PV.TagName", false);
graphicInfo.Identity = "i1";
graphicInfo.GraphicName = "S1";
graphicInfo.OwningObject = "UserDefined_001";
graphicInfo.WindowTitle = "Graphic01";
graphicInfo.Resizable = false;
graphicInfo.CustomProperties=cpValues;
ShowGraphic( graphicInfo );