HTGetValueAtZone(), fonction

La fonction HTGetValueAtZone() renvoie une valeur du type requis, pour les données comprises entre les positions des curseurs droit et gauche, pour la plume spécifiée d’une courbe.

Catégorie

Historique

Syntaxe

RealResult=HTGetValueAtZone(Var_Hist,UpdateCount,
Scoot1Loc,Scoot2Loc,NumPlume,Texte_TypeValeur);

Arguments :

Var_hist

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

.UpdateCount

Entier représentant le .champ .UpdateCount de la courbe. Utilisé uniquement comme déclencheur pour réévaluer la fonction.

EmplScooter1

Réel représentant le .champ ScooterPosLeft de la courbe. Utilisé uniquement comme déclencheur pour réévaluer la fonction.

EmplScooter2

Réel représentant le .champ ScooterPosRight de la courbe. Utilisé uniquement comme déclencheur pour réévaluer la fonction.

PenNum

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

ValType_Text

Chaîne indiquant le type de valeur à renvoyer.

PenAverageValue = Moyenne de la zone comprise entre les curseurs.

PenMaxValue = Valeur maximum de la zone comprise entre les curseurs.

PenMinValue = Valeur minimum de la zone comprise entre les curseurs.

PenMaxEU = Valeur UM maximum de la zone comprise entre les curseurs.

PenMinEU = Valeur UM minimum de la zone comprise entre les curseurs.

PenStdDev = Écart type de la zone comprise entre les curseurs.

Remarques

Une variable de type réel représentant la valeur calculée du type spécifié est renvoyée. La définition de valeurs constantes pour les arguments Scoot1Loc et Scoot2Loc n’a aucun effet et ne sert qu’à déclencher l’évaluation de la fonction. La fonction utilise directement les valeurs des .champs .ScooterPosLeft et .ScooterPosRight, sans tenir compte des valeurs spécifiée pour les arguments Scoot1Loc et Scoot2Loc.

Exemple

L’instruction suivante calcule la moyenne des données comprises entre les curseurs droit et gauche de la courbe Graphe1 pour la plume 1. La valeur obtenue est stockée dans la variable mémoire de type réel AvgValue :

AvgValue=HTGetValueAtZone("Graphe1", Graphe1.UpdateCount,Graphe1.ScooterPosLeft, Graphe1.ScooterPosRight,1,"PenAverageValue");