​.ScooterPosLeft Dotfield

The .ScooterPosLeft dotfield dynamically controls the position of the left scooter on a historical trend.

Category

Historical

Usage

HistTrendTag.ScooterPosLeft

Parameter

HistTrendTag

HistTrend tag assigned the name of the trend.

Remarks

This read/write dotfield dynamically controls the position of the left scooter. You can use this dotfield in a QuickScript function to retrieve the current position of the left scooter, or you can assign a value to this dotfield to adjust the position of the left scooter to another location on the trend.

This dotfield is most often used in conjunction with the set of HTGetValue() functions. These functions must specify which historical trend is being queried, as well as the current position of the trend's scooters.

Data Type

Real (read/write).

Valid Values

0.0 to 1.0; where 0.0 is the extreme left of the historical trend chart, and 1.0 is the extreme right of the historical trend chart.

Examples

The following example repositions the left scooter. The left scooter moves to a location 34 percent of the chart's total length from the left side of the historical trend chart currently associated with the MyHistTrendTag tag.

MyHistTrendTag.ScooterPosLeft=.34;

In the following statement, the QuickScript HTGetValueAtScooter() function retrieves the value of pen 1 at the left scooter's current position. A change to any value within a function's argument list causes the function to be re-evaluated. Each time the position of the left scooter changes, this statement is re-evaluated.

MyRealTag=HTGetValueAtScooter (MyHistTrendTag,MyHistTrendTag.UpdateCount, 1, MyHistTrendTag.ScooterPosLeft, 1, "PenValue");

See Also

.ScooterPosRight, .ScooterLockLeft, .ScooterLockRight