Werte für die benutzerdefinierten Eigenschaften einer Grafik übergeben

Wenn Sie eine Grafik mittels der Funktion ShowGraphic() öffnen, können Sie auch gleich Werte für dessen benutzerdefinierte Eigenschaften übergeben. Hierzu dient die Eigenschaft CustomProperties des GraphicInfo-Objekts.

Die Parameter der Eigenschaft „CustomProperties“ sind der Namen der benutzerdefinierten Eigenschaft, der zugeordnete Wert und das Boolesche Flag IsConstant, das angibt, ob der Wert als konstanter Wert ist. Die Parameter mit Standardwert in der GraphicInfo sind optional. Wenn für diese Parameter kein Wert festgelegt wird, werden bei Laufzeit die Standardwerte verwendet. Alle Parameter außer dem Datentyp Enum können ein konstanter Wert, ein Verweis und ein Ausdruck sein. Wenn Sie den Objektbrowser verwenden, um ein Objekt auszuwählen und automatisch in das Skript einzufügen, setzt der Skript-Editor den Objektnamen in doppelte Anführungszeichen. Wenn Sie den Objektnamen manuell hinzufügen, achten Sie darauf, ihn in Anführungszeichen zu setzen.

Die Einträge des Arrays sind Objekte des Typs aaGraphic.CustomPropertyValuePair[]. Der Array-Index beginnt bei 1.

Wenn ein Attributname nicht in Anführungszeichen eingeschlossen ist, während er einer benutzerdefinierten Eigenschaft mit dem Array CustomPropertyValuePair[] zugewiesen wird, wird die Qualität des Attributs nicht von der benutzerdefinierten Eigenschaft übernommen.

Verwenden Sie ein Skript wie das folgende, um den benutzerdefinierten Eigenschaften einer Grafik Werte zuzuweisen. In diesem Beispiel ist „i1“ die Zeichenfolge Identity und die Grafik „S1“ enthält die benutzerdefinierten Eigenschaften CP1 und CP2. Durch dieses Skript erhält CP1 den konstanten Wert 20, CP2 erhält den aktuellen Wert des Attributs „Pumpe.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 );