HTSetPenName(), fonction

La fonction HTSetPenName() associe une variable à une plume de la courbe.

Catégorie

Historique

Syntaxe

HTSetPenName(Var_Hist,NumPlume,NomVar);

Arguments :

Var_hist

Variable de type « courbe historique », renseignée avec le nom de la courbe.

PenNum

Variable de type entier ou valeur représentant le numéro de plume (1 à 8) de la courbe.

NomVariable

Nom de la nouvelle variable à associer à la plume.

Remarques

Cette fonction QuickScript est la seule méthode permettant d’ajouter des variables provenant d’un fournisseur de données historiques distribuées, pendant l’exploitation.

Vous pouvez saisir une référence de 49 caractères maximum dans un nom de plume.

Le message d’erreur suivant peut apparaître si vous tentez d’annuler l’association d’une plume :

VIEW /UpdateData: Invalid DBS.NomVar handle – 0

Cette erreur se produit si vous annulez l’association d’une plume préalablement associé à une variable distante sous la forme fournisseurhistorique.nomvariable. Pour éviter cette erreur, créez une variable locale journalisée, en cochant la case Enregis. données. Ensuite, utilisez le script suivant pour annuler l’association :

HTSetPenName( "HistTrend", 1, "localtag" );

{assigns the pen to a locally logged tag---localtag}

HistTrend.Pen1=None ;

{unassigns the pen}

Où None est une variable de type TagID.

Exemples

L’instruction suivante associe la variable OutletPressure à la plume 3 de la courbe Graphe1.

HTSetPenName("Graphe1",3,"OutletPressure");

L’instruction suivante associe la variable HistPrv1.Tag1 à la quatrième plume (PlumeCourbe4) de la courbe Graphe1.

HTSetPenName("Graphe1",PlumeCourbe4,"HistPrv1.Tag1");

Voir aussi

HTSelectTag(), fonction