Attribuer des valeurs de propriétés personnalisées à un graphique

Il est possible de définir des propriétés personnalisées dans un graphique avec des valeurs quand le graphique affiché avec la fonction ShowGraphic() possède la propriété CustomProperties.

Les paramètres de la propriété CustomProperties sont le nom de la propriété personnalisée, une valeur attribuée et l'indicateur booléen IsConstant pour indiquer si la valeur de la propriété personnalisée est une constante. Tout paramètre avec une valeur par défaut dans GraphicInfo est facultatif. Si aucune valeur n'est spécifiée for ces paramètres, ces valeurs par défaut sont celles utilisées pendant l'exploitation. Tout paramètre, à l'exception du type de donnée Enum, qui peut être une constante, une référence ou une expression. Lorsque vous utilisez l'Explorateur d’objets pour sélectionner et insérer automatiquement un objet dans le script, l'éditeur de script ajoute des guillemets autour du nom de l'objet. Si vous ajoutez le nom de l'objet manuellement, veillez à le placer entre guillemets.

Ces paramètres sont spécifiés comme un tableau de valeurs déclarées avec un tableau CustomPropertyValuePair[]. Le premier index du tableau est 1.

Si le nom d'un attribut n'est pas entouré de guillemets lors de son affectation à une propriété personnalisée à l'aide du tableau CustomPropertyValuePair[], la qualité de l'attribut ne sera pas reprise par la propriété personnalisée.

Utilisez un script similaire à ceux suivants pour attribuer des valeurs aux propriétés personnalisées d'un graphique. Dans cet exemple, « i1 » est une chaîne Identity et le graphique « S1 » contient les propriétés personnalisées CP1 et CP2. Quand S1 est affiché pendant l'exploitation, CP1 est renseigné avec une valeur constante de 20 et CP2 est renseigné avec la valeur courante de la référence laPompe.PV.Tagname.

Dim graphicInfo comme aaGraphic.GraphicInfo;

Dim cpValeurs [2] as aaGraphic.CustomPropertyValuePair;

cpValeurs[1] = new

aaGraphic.CustomPropertyValuePair("CP1", 20, true);

cpValeurs[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=cpValeurs;

ShowGraphic( graphicInfo );