HTGetValueAtZone (Funktion)

Die Funktion HTGetValueAtZone() gibt einen Wert des angegebenen Typs für die Daten zurück, die zwischen der rechten und linken Anzeigelineal-Position für den angegebenen Trendstift stehen.

Kategorie

Archivdaten

Syntax

Ergebnis=HTGetValueAtZone(Archiv_Variable,Aktualisierungszähler,
Lineal1Pos,Lineal2Pos,Stiftnummer,Werttyp);

Argumente

Archiv_Variable

Beliebige Variable vom Typ "Hist. Trend".

Aktualisierungszähler

Integer-Wert, der das .UpdateCount-Feld des Trends darstellt. Wenn sich der Wert dieses Arguments ändert, wird die Funktion erneut ausgeführt und der Rückgabewert aktualisiert.

Lineal1Pos

Real-Wert, der die Position des linken Anzeigelineals darstellt. Sie können hierfür das Punktfeld .ScooterPosLeft des Trends einsetzen. Wenn sich der Wert dieses Arguments ändert, wird die Funktion erneut ausgeführt und der Rückgabewert aktualisiert.

Lineal2Pos

Real-Wert, der die Position des rechten Anzeigelineals darstellt. Sie können hierfür das Punktfeld .ScooterPosRight des Trends einsetzen. Wenn sich der Wert dieses Arguments ändert, wird die Funktion erneut ausgeführt und der Rückgabewert aktualisiert.

Stiftnummer

Nummer des Stifts (1-8) als Integer-Variable oder Zahl.

Werttyp

Zeichenfolge, die den Typ des Rückgabewerts angibt.

PenAverageValue = Mittelwert für den Bereich zwischen den Anzeigelinealen

PenMaxValue = Höchstwert für den Bereich zwischen den Anzeigelinealen

PenMinValue = Mindestwert für den Bereich zwischen den Anzeigelinealen

PenMaxEU = Höchstwert in Engineering Units für den Bereich zwischen den Anzeigelinealen

PenMinEU = Mindestwert in Engineering Units für den Bereich zwischen den Anzeigelinealen

PenStdDev = Standardabweichung für den Bereich zwischen den Anzeigelinealen

Anmerkungen

Der berechnete Wert des angegebenen Typs wird als Real-Wert zurückgegeben. Die Argumente "Lineal1Pos" und "Lineal2Pos" werden ausschließlich als Auslöser verwendet, um die Funktion erneut auszuführen und den Rückgabewert zu aktualisieren, wenn die Funktion in einer Animationsverknüpfung verwendet wird. Wenn dies nicht erforderlich ist, können Sie für diese Argumente auch konstante Werte angeben. Unabhängig vom Wert dieser Argumente wird der Bereich, für den der zurückgegebene Wert berechnet wird, immer anhand der tatsächlichen Position der beiden Anzeigelineale bestimmt.

Beispiel

Mit der folgenden Anweisung berechnen Sie den Mittelwert der Daten zwischen dem rechten und dem linken Anzeigelineal für Stift 1 in "Trend1". Der Wert wird in der Real-Variablen "DurchschnittWert" gespeichert:

DurchschnittWert=HTGetValueAtZone("Trend1", Trend1.UpdateCount,Trend1.ScooterPosLeft, Trend1.ScooterPosRight,1,"PenAverageValue");